@gjsify/adwaita-web 0.64.2-next.252 → 0.64.2-next.254

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

@@ -1,6 +1,7 @@
 import type { Toast, ToastScheduler } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 export type { ToastScheduler, ToastTimerHandle } from '@gjsify/adwaita-core';
-export declare class AdwToastOverlay extends HTMLElement {
+export declare class AdwToastOverlay extends WidgetElement {
     private _toasts;
     private _initialized;
     /** The headless queue of `adw-toast-overlay.c` (ADR 0004). */

package/lib/types/elements/adw-toggle-group.d.ts

@@ -1,9 +1,10 @@
+import { WidgetElement } from '../widget-element.js';
 /** A single toggle. Children of <adw-toggle-group>; consumed at connect time. */
-export declare class AdwToggle extends HTMLElement {
+export declare class AdwToggle extends WidgetElement {
     static get observedAttributes(): string[];
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
 }
-export declare class AdwToggleGroup extends HTMLElement {
+export declare class AdwToggleGroup extends WidgetElement {
     private _innerEl;
     private _buttons;
     /** The headless segment list + guarded selection state machine (ADR 0004). */

package/lib/types/elements/adw-toolbar-view.d.ts

@@ -1,4 +1,5 @@
-export declare class AdwToolbarView extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwToolbarView extends WidgetElement {
     private _topEl;
     private _contentEl;
     private _bottomEl;

package/lib/types/elements/adw-view-stack.d.ts

@@ -1,7 +1,8 @@
 import type { AdwViewStackPageInfo as CorePageInfo } from '@gjsify/adwaita-core';
 import type { DispatchedSignals } from '../signals.js';
+import { WidgetElement } from '../widget-element.js';
 export type AdwViewStackPageInfo = CorePageInfo<HTMLElement>;
-export declare class AdwViewStack extends HTMLElement {
+export declare class AdwViewStack extends WidgetElement {
     /** The GTK signals this element dispatches, each with the DOM event it arrives as (ADR 0093). */
     static readonly signals: DispatchedSignals;
     private readonly _state;
@@ -60,6 +61,7 @@ export declare class AdwViewStack extends HTMLElement {
      */
     private _emitItemsChanged;
     private _onStateChange;
+    private _onChildrenRemoved;
     private _applyVisibility;
     private _reflectName;
 }

package/lib/types/elements/adw-view-switcher-bar.d.ts

@@ -1,5 +1,6 @@
 import type { AdwViewStack } from './adw-view-stack.js';
-export declare class AdwViewSwitcherBar extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwViewSwitcherBar extends WidgetElement {
     private readonly _barState;
     private _barEl;
     private _nodes;

package/lib/types/elements/adw-view-switcher-sidebar.d.ts

@@ -1,6 +1,7 @@
 import type { SidebarItemFilter } from '@gjsify/adwaita-core';
 import type { AdwViewStack } from './adw-view-stack.js';
-export declare class AdwViewSwitcherSidebar extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwViewSwitcherSidebar extends WidgetElement {
     private _sidebar;
     private _placeholderEl;
     private _prefixEl;

package/lib/types/elements/adw-view-switcher.d.ts

@@ -1,5 +1,6 @@
 import type { ViewSwitcherScheduler } from '@gjsify/adwaita-core';
 import type { AdwViewSwitcherPage as AdwViewSwitcherPageInfo, AdwViewSwitcherPolicy } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /**
  * A single page. Children of `<adw-view-switcher>`; consumed at connect time.
  *
@@ -9,9 +10,9 @@ import type { AdwViewSwitcherPage as AdwViewSwitcherPageInfo, AdwViewSwitcherPol
  * switcher watches them with a `MutationObserver` instead — the DOM stand-in for
  * the per-page `notify` C rebinds on.
  */
-export declare class AdwViewSwitcherPage extends HTMLElement {
+export declare class AdwViewSwitcherPage extends WidgetElement {
 }
-export declare class AdwViewSwitcher extends HTMLElement {
+export declare class AdwViewSwitcher extends WidgetElement {
     /**
      * The dwell timer, injectable so a test can hand in a clock and drive
      * `VIEW_SWITCHER_DRAG_VECTORS` against the real element. Replace it before the

package/lib/types/elements/adw-window-title.d.ts

@@ -1,4 +1,5 @@
-export declare class AdwWindowTitle extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwWindowTitle extends WidgetElement {
     private _titleEl;
     private _subtitleEl;
     /** The headless title/subtitle pair + change detection (ADR 0004). */

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

@@ -1,5 +1,6 @@
 import { type AdwLengthUnit } from '@gjsify/adwaita-core';
-export declare class AdwWrapBox extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwWrapBox extends WidgetElement {
     private _initialized;
     static get observedAttributes(): ("orientation" | "align" | "child-spacing" | "child-spacing-unit" | "pack-direction" | "justify" | "justify-last-line" | "line-spacing" | "line-spacing-unit" | "line-homogeneous" | "natural-line-length" | "natural-line-length-unit" | "wrap-reverse" | "wrap-policy")[];
     /** Spacing between children on the same line, in `child-spacing-unit`. */

package/lib/types/elements/checks.d.ts

@@ -1,4 +1,5 @@
 import type { DispatchedSignals } from '../signals.js';
+import { WidgetElement } from '../widget-element.js';
 /**
  * The markup + state shared by `<gtk-check-button>` and `<adw-radio>`.
  *
@@ -7,7 +8,7 @@ import type { DispatchedSignals } from '../signals.js';
  * `.adw-check-indicator` and `.adw-check-label`, which are the Adwaita SKIN, and the
  * skin is not what the tag names. It is also not a widget — nothing registers it.
  */
-declare abstract class AdwCheckBase extends HTMLElement {
+declare abstract class AdwCheckBase extends WidgetElement {
     protected _input: HTMLInputElement;
     protected _indicator: HTMLSpanElement;
     protected _label: HTMLSpanElement;
@@ -41,6 +42,20 @@ export declare class GtkCheckButton extends AdwCheckBase {
     static readonly signals: DispatchedSignals;
     static get observedAttributes(): string[];
     protected get inputType(): 'checkbox';
+    /**
+     * `Gtk.CheckButton:group`, WRITE-ONLY as in GTK (`G_PARAM_WRITABLE`, gtkcheckbutton.c:665-668):
+     * another check button, or its id as a projected `.blp` writes it, or `null` to leave.
+     */
+    set group(value: GtkCheckButton | string | null);
+    /** `gtk_check_button_set_group`. */
+    set_group(group: GtkCheckButton | null): void;
+    get_active(): boolean;
+    set_active(active: boolean): void;
+    attributeChangedCallback(name: string): void;
+    protected onConnected(): void;
+    /** The `group` attribute names a check button by id, looked up once the tree is in a document. */
+    private _resolveGroup;
+    protected render(): void;
     protected activate(): void;
 }
 /** The Adwaita radio — `checkbutton > radio`, exclusive within its `name`. */

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

@@ -1,4 +1,5 @@
-export declare class GtkActionBar extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkActionBar extends WidgetElement {
     private _initialized;
     private _startEl;
     private _centerEl;

package/lib/types/elements/gtk-aspect-frame.d.ts

@@ -1,4 +1,5 @@
-export declare class GtkAspectFrame extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkAspectFrame extends WidgetElement {
     static get observedAttributes(): string[];
     /** `Gtk.AspectFrame:ratio` — the width/height of the child. Ignored under `obey-child`. */
     get ratio(): number;

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

@@ -1,5 +1,7 @@
 import { type BoxOrientation } from '@gjsify/adwaita-core';
-export declare class GtkBox extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkBox extends WidgetElement {
+    private _expandObserver;
     static get observedAttributes(): ("spacing" | "orientation" | "homogeneous")[];
     /** `GtkOrientable:orientation` — `horizontal` (the default) or `vertical`. */
     get orientation(): BoxOrientation;
@@ -11,7 +13,9 @@ export declare class GtkBox extends HTMLElement {
     get homogeneous(): boolean;
     set homogeneous(value: boolean);
     connectedCallback(): void;
+    disconnectedCallback(): void;
     attributeChangedCallback(name: string, old: string | null, value: string | null): void;
     private _normalized;
     private _sync;
+    private _syncComputedExpand;
 }

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

@@ -1,5 +1,6 @@
 import type { DispatchedSignals } from '../signals.js';
-export declare class GtkButton extends HTMLElement {
+import { TooltipElement } from '../widget-element.js';
+export declare class GtkButton extends TooltipElement {
     /** The GTK signals this element dispatches, each with the DOM event it arrives as (ADR 0093). */
     static readonly signals: DispatchedSignals;
     private _button;
@@ -9,17 +10,14 @@ export declare class GtkButton extends HTMLElement {
     private _child;
     static get observedAttributes(): string[];
     /**
-     * `Gtk.Button:icon-name` and `Gtk.Widget:tooltip-text`, the GObject spellings: a class that
-     * holds a button as a template child writes `button.icon_name = …`, which must reach the DOM.
+     * `Gtk.Button:icon-name`, the GObject spelling: a class that holds a button as a template
+     * child writes `button.icon_name = …`, which must reach the DOM. `Gtk.Widget:tooltip-text`
+     * comes from `TooltipElement`.
      */
     get icon_name(): string | null;
     set icon_name(value: string | null);
     get iconName(): string | null;
     set iconName(value: string | null);
-    get tooltip_text(): string | null;
-    set tooltip_text(value: string | null);
-    get tooltipText(): string | null;
-    set tooltipText(value: string | null);
     private reflect;
     /** The inner native button (for focus/imperative access). */
     get button(): HTMLButtonElement;

package/lib/types/elements/gtk-calendar.d.ts

@@ -1,5 +1,6 @@
 import { type AdwCalendarCell, type AdwCalendarDate } from '@gjsify/adwaita-core';
-export declare class GtkCalendar extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkCalendar extends WidgetElement {
     private _headerEl;
     private _monthEl;
     private _yearEl;

package/lib/types/elements/gtk-center-box.d.ts

@@ -1,3 +1,4 @@
+import { WidgetElement } from '../widget-element.js';
 /** `Gtk.BaselinePosition`'s three nicks, in the order GTK measures them (gtkcenterbox.c:267-271). */
 declare const BASELINE_POSITIONS: {
     readonly top: 0;
@@ -5,7 +6,7 @@ declare const BASELINE_POSITIONS: {
     readonly bottom: 1;
 };
 export type BaselinePosition = keyof typeof BASELINE_POSITIONS;
-export declare class GtkCenterBox extends HTMLElement {
+export declare class GtkCenterBox extends WidgetElement {
     static get observedAttributes(): string[];
     /**
      * `Gtk.CenterBox:baseline-position` — `top`, `center` (the pspec default) or `bottom`.

package/lib/types/elements/gtk-color-dialog-button.d.ts

@@ -1,3 +1,4 @@
+import { WidgetElement } from '../widget-element.js';
 /** A `GdkRGBA` — the four channels of `GtkColorDialogButton:rgba`, each 0…1. */
 export interface GdkRgbaValue {
     red: number;
@@ -17,7 +18,7 @@ export interface ColorDialogParameters {
     /** Whether colours may carry alpha. Default `TRUE`, as in the GIR. */
     withAlpha?: boolean;
 }
-export declare class GtkColorDialogButton extends HTMLElement {
+export declare class GtkColorDialogButton extends WidgetElement {
     private _buttonEl;
     private _swatchEl;
     private _inputEl;

package/lib/types/elements/gtk-drag-icon.d.ts

@@ -1,3 +1,4 @@
+import { WidgetElement } from '../widget-element.js';
 /** The `rgba()` string a `GdkRGBA` value paints, as the colour swatch shows it. */
 interface Rgba {
     readonly red: number;
@@ -5,7 +6,7 @@ interface Rgba {
     readonly blue: number;
     readonly alpha?: number;
 }
-export declare class GtkDragIcon extends HTMLElement {
+export declare class GtkDragIcon extends WidgetElement {
     private _pointerX;
     private _pointerY;
     private _dragging;

package/lib/types/elements/gtk-drawing-area.d.ts

@@ -1,3 +1,4 @@
+import { WidgetElement } from '../widget-element.js';
 /**
  * `GtkDrawingAreaDrawFunc` with the `user_data` / `destroy` pair dropped — see the header.
  *
@@ -7,7 +8,7 @@
  * @param height the height of the allocation — NOT of `content-height`
  */
 export type GtkDrawingAreaDrawFunc = (area: GtkDrawingArea, cr: CanvasRenderingContext2D, width: number, height: number) => void;
-export declare class GtkDrawingArea extends HTMLElement {
+export declare class GtkDrawingArea extends WidgetElement {
     private _canvas;
     private _context;
     private _initialized;

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

@@ -1,13 +1,14 @@
 import './gtk-popover.js';
 import type { AdwComboOption, AdwListModelInput } from '@gjsify/adwaita-core';
 import type { DispatchedSignals } from '../signals.js';
+import { WidgetElement } from '../widget-element.js';
 /**
  * A dropdown option — `value` is the stable id, `label` the shown text. An alias of
  * core's {@link AdwComboOption}, since the drop-down and the combo row are the same
  * selection model behind two chromes; still exported so the published name keeps working.
  */
 export type GtkDropDownOption = AdwComboOption;
-export declare class GtkDropDown extends HTMLElement {
+export declare class GtkDropDown extends WidgetElement {
     /** The GTK signals this element dispatches, each with the DOM event it arrives as (ADR 0093). */
     static readonly signals: DispatchedSignals;
     private _buttonEl;

package/lib/types/elements/gtk-editable-label.d.ts

@@ -1,4 +1,5 @@
-export declare class GtkEditableLabel extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkEditableLabel extends WidgetElement {
     private _label;
     private _entry;
     private _initialized;

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

@@ -1,5 +1,6 @@
 import type { DispatchedSignals } from '../signals.js';
-export declare class GtkEntry extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkEntry extends WidgetElement {
     /**
      * `protected`, not `private`: `GtkPasswordEntry` and `GtkSearchEntry` subclass this
      * element and restyle or wrap the very input it builds (the password field's Caps Lock

package/lib/types/elements/gtk-expander.d.ts

@@ -1,5 +1,6 @@
 import './gtk-label.js';
-export declare class GtkExpander extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkExpander extends WidgetElement {
     private _box;
     private _titleEl;
     private _arrowEl;

package/lib/types/elements/gtk-fixed.d.ts

@@ -1,4 +1,5 @@
-export declare class GtkFixed extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkFixed extends WidgetElement {
     private _resize;
     private _mutations;
     connectedCallback(): void;

package/lib/types/elements/gtk-flow-box-child.d.ts

@@ -1,4 +1,5 @@
-export declare class GtkFlowBoxChild extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkFlowBoxChild extends WidgetElement {
     private _contentsEl;
     private _initialized;
     connectedCallback(): void;

package/lib/types/elements/gtk-flow-box.d.ts

@@ -1,11 +1,12 @@
 import { type AdwBoxSelectionMode } from '@gjsify/adwaita-core';
 import type { GtkFlowBoxChild } from './gtk-flow-box-child.js';
 import './gtk-flow-box-child.js';
+import { WidgetElement } from '../widget-element.js';
 /** `GtkFlowBox:max-children-per-line`'s default — `DEFAULT_MAX_CHILDREN_PER_LINE` (:728). */
 export declare const ADW_FLOW_BOX_MAX_CHILDREN_PER_LINE = 7;
 /** `GtkFlowBox:orientation` — HORIZONTAL by default here, unlike a `GtkListBase` (:3981). */
 export type AdwFlowBoxOrientation = 'horizontal' | 'vertical';
-export declare class GtkFlowBox extends HTMLElement {
+export declare class GtkFlowBox extends WidgetElement {
     private _children;
     private _selection;
     /** `priv->selected_child`, `-1` for the C's NULL. */

package/lib/types/elements/gtk-font-dialog-button.d.ts

@@ -1,6 +1,7 @@
 import { type PangoFontDescription } from '../font-description.js';
 import './gtk-popover.js';
 import './gtk-separator.js';
+import { WidgetElement } from '../widget-element.js';
 /** `GtkFontLevel`'s four values, under the nicks a string property carries. */
 export type FontLevel = 'family' | 'face' | 'font' | 'features';
 /** `GtkFontDialog`'s own parameters; `font-map` has no browser counterpart and is absent. */
@@ -14,7 +15,7 @@ export interface FontDialogParameters {
     /** Whether only scalable fonts are offered. */
     filter?: number;
 }
-export declare class GtkFontDialogButton extends HTMLElement {
+export declare class GtkFontDialogButton extends WidgetElement {
     private _buttonEl;
     private _labelEl;
     private _sizeBoxEl;

package/lib/types/elements/gtk-frame.d.ts

@@ -1,4 +1,5 @@
-export declare class GtkFrame extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkFrame extends WidgetElement {
     private _mutations;
     static get observedAttributes(): string[];
     /** The element's own `<gtk-label>`, built from `label` — null while no string is set. */

package/lib/types/elements/gtk-gl-area.d.ts

@@ -1,9 +1,10 @@
+import { WidgetElement } from '../widget-element.js';
 /** `GdkGLAPI`'s nicks, as `GdkGLAPINickSet` spells them. */
 declare const APIS: readonly ["gl", "gles"];
 type GlApi = (typeof APIS)[number];
 /** A WebGL context, whichever version the browser handed out. */
 type GlContext = WebGLRenderingContext | WebGL2RenderingContext;
-export declare class GtkGLArea extends HTMLElement {
+export declare class GtkGLArea extends WidgetElement {
     private _canvas;
     private _messageEl;
     private _initialized;

package/lib/types/elements/gtk-graphics-offload.d.ts

@@ -1,6 +1,7 @@
+import { WidgetElement } from '../widget-element.js';
 /** `GtkGraphicsOffloadEnabled`, spelled as the GIR's enum nicks. */
 type OffloadEnabled = 'enabled' | 'disabled';
-export declare class GtkGraphicsOffload extends HTMLElement {
+export declare class GtkGraphicsOffload extends WidgetElement {
     private _childEl;
     private _initialized;
     static get observedAttributes(): string[];

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

@@ -1,5 +1,6 @@
 import { type BoxOrientation } from '@gjsify/adwaita-core';
-export declare class GtkGrid extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkGrid extends WidgetElement {
     static get observedAttributes(): string[];
     /** `Gtk.Grid:column-spacing` — the gap between two consecutive columns. Defaults to 0. */
     get columnSpacing(): number;

package/lib/types/elements/gtk-header-bar.d.ts

@@ -1,5 +1,6 @@
 import './gtk-window-controls.js';
-export declare class GtkHeaderBar extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkHeaderBar extends WidgetElement {
     private _initialized;
     private _handle;
     private _box;

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

@@ -1,7 +1,6 @@
+import { WidgetElement } from '../widget-element.js';
 /**
- * The generated mask-class prefix — the one place the `--` spelling appears. `icon-registry`
- * builds the same class for a runtime registration and imports it from here rather than
- * spelling it twice.
+ * The generated mask-class prefix — the one place the `--` spelling appears.
  */
 export declare const MASK_CLASS_PREFIX = "adw-icon--";
 /**
@@ -16,15 +15,15 @@ export declare const MISSING_ICON_NAME = "image-missing";
  * as "a mask is applied", and a colour icon has none.
  */
 export declare const COLOR_ICON_CLASS = "adw-icon-color";
-export declare class GtkImage extends HTMLElement {
+export declare class GtkImage extends WidgetElement {
     static get observedAttributes(): string[];
     /** The declared symbolic name, `-symbolic` suffix optional. */
     get iconName(): string;
     set iconName(value: string | null);
     /**
      * The name the SYMBOLIC lookup works with — `''` when the icon-name is absent, empty,
-     * or not usable as one CSS token. A registered colour icon can still draw for a name
-     * that answers `''` here (`org.gnome.Builder`); whether a name draws anything but
+     * or not usable as one CSS token. A resource file can still draw for a name that
+     * answers `''` here (`org.gnome.Builder`); whether a name draws anything but
      * `image-missing` is `isIconAvailable`'s question.
      *
      * `''` does NOT mean the box draws nothing: an unusable name that was given still

package/lib/types/elements/gtk-inscription.d.ts

@@ -1,4 +1,5 @@
 import { type LabelWrapMode } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** `GtkInscriptionOverflow`, in enum order (gtkinscription.h:44-48). */
 export declare const INSCRIPTION_OVERFLOW_MODES: readonly ["clip", "ellipsize-start", "ellipsize-middle", "ellipsize-end"];
 export type InscriptionOverflow = (typeof INSCRIPTION_OVERFLOW_MODES)[number];
@@ -15,7 +16,7 @@ export declare const DEFAULT_INSCRIPTION_WRAP_MODE: LabelWrapMode;
 export declare function normalizeInscriptionOverflow(value: unknown): InscriptionOverflow;
 /** `GtkInscription:wrap-mode` from its nick, with {@link DEFAULT_INSCRIPTION_WRAP_MODE}. */
 export declare function normalizeInscriptionWrapMode(value: unknown): LabelWrapMode;
-export declare class GtkInscription extends HTMLElement {
+export declare class GtkInscription extends WidgetElement {
     private _initialized;
     static get observedAttributes(): string[];
     /** `GtkInscription:text` — the plain string to draw (gtkinscription.c:713-717). */

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

@@ -1,5 +1,6 @@
 import { type LabelEllipsizeMode, type LabelJustification, type LabelWrapMode } from '@gjsify/adwaita-core';
-export declare class GtkLabel extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkLabel extends WidgetElement {
     /**
      * The rendered text's own box — present while {@link wrap} is set (so it can be pinned
      * to its measured wrap width, see `_remeasure`) OR while {@link ellipsize} is not
@@ -110,9 +111,15 @@ export declare class GtkLabel extends HTMLElement {
      * here, not the narrower width GTK's Pango layout actually wrapped to. So this measures
      * instead, in two passes: first let {@link _wrapSpan} wrap at the FULL container width
      * (`width: ''`, the same collapse above, which is exactly the width GTK's own
-     * allocation wraps against), then pin the span to its widest resulting line via
+     * allocation wraps against), then cap the span at its widest resulting line via
      * `Range.getClientRects()`, which gives the pseudo spacers real free space to split.
-     * Approximate on purpose, and cheap: one synchronous reflow per render. The pinned
+     * A CAP, `max-width`, and never `width`: a pinned `width` is also the span's
+     * min-content, so the label could no longer shrink below the width it first wrapped
+     * at, and a card holding it in a narrower pane grew past the pane and was clipped.
+     * GtkLabel's wrapping minimum is its widest word (`gtk_label_measure`), which a capped
+     * flex item keeps as its min-content; the cap itself only resolves against a definite
+     * container, so the label's max-content stays its text on one line, GTK's natural.
+     * Approximate on purpose, and cheap: one synchronous reflow per render. The measured
      * width goes stale whenever the available width or the font changes, and a page does
      * both (a rotated phone, an opened sidebar, a web font arriving late), so
      * {@link connectedCallback} re-measures on each resize and once the fonts have loaded.

package/lib/types/elements/gtk-level-bar.d.ts

@@ -1,7 +1,8 @@
 import { type BoxOrientation } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** `GtkLevelBarMode`, spelled as the GIR's enum nicks (:1004-1008). */
 type LevelBarMode = 'continuous' | 'discrete';
-export declare class GtkLevelBar extends HTMLElement {
+export declare class GtkLevelBar extends WidgetElement {
     private _trough;
     private _initialized;
     /** Offset name → value, kept sorted ascending exactly as the C's `GList` is. */

package/lib/types/elements/gtk-list-box-row.d.ts

@@ -1,4 +1,5 @@
-export declare class GtkListBoxRow extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkListBoxRow extends WidgetElement {
     private _contentsEl;
     private _activation?;
     private _initialized;

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

@@ -1,11 +1,12 @@
 import { type AdwBoxSelectionMode } from '@gjsify/adwaita-core';
 import type { GtkListBoxRow } from './gtk-list-box-row.js';
 import './gtk-list-box-row.js';
+import { WidgetElement } from '../widget-element.js';
 /** `GtkListTabBehavior`'s nicks — `cell` behaves as `item` outside a cell-based box. */
 export type GtkListTabBehavior = 'all' | 'item' | 'cell';
 /** An unknown nick is `all`, the ParamSpec's default (gtklistbox.c:574-578). */
 export declare function normalizeListTabBehavior(raw: string | null | undefined): GtkListTabBehavior;
-export declare class GtkListBox extends HTMLElement {
+export declare class GtkListBox extends WidgetElement {
     private _rows;
     private _selection;
     /** `box->selected_row`, `-1` for the C's NULL. */

package/lib/types/elements/gtk-list-view.d.ts

@@ -1,9 +1,10 @@
 import { ListViewState, type AdwComboOption, type AdwListItemFactory, type AdwListModelInput, type AdwListSelectionMode, type BoxOrientation } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** `GtkListTabBehavior`'s nicks — `cell` behaves as `item` outside a cell-based view. */
 export type GtkListTabBehavior = 'all' | 'item' | 'cell';
 /** An unknown nick is `all`, the ParamSpec's default (gtklistview.c:965-969). */
 export declare function normalizeListTabBehavior(raw: string | null | undefined): GtkListTabBehavior;
-export declare class GtkListView extends HTMLElement {
+export declare class GtkListView extends WidgetElement {
     protected _listEl: HTMLDivElement;
     protected _rows: HTMLElement[];
     /** The model + selection machine all three views share (ADR 0004, ADR 0089). */

package/lib/types/elements/gtk-media-controls.d.ts

@@ -1,3 +1,4 @@
+import { WidgetElement } from '../widget-element.js';
 /**
  * The four `audio-volume-*` names `GtkVolumeButton` derives from a 0…1 level, one constant
  * each rather than an array of them, in the ORDER `icons_symbolic` holds them
@@ -53,7 +54,7 @@ export declare function volumeIconFor(volume: number): string;
  *   as it is not in the C — see above.
  */
 export declare function mediaTimeToString(seconds: number, remaining?: boolean, forceHour?: boolean): string;
-export declare class GtkMediaControls extends HTMLElement {
+export declare class GtkMediaControls extends WidgetElement {
     private _initialized;
     private _playButton;
     private _timeLabel;

package/lib/types/elements/gtk-menu-button.d.ts

@@ -1,6 +1,7 @@
 import type { AdwMenuActions, AdwMenuInput, AdwMenuModel, SplitButtonDirection } from '@gjsify/adwaita-core';
 import './gtk-popover.js';
-export declare class GtkMenuButton extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkMenuButton extends WidgetElement {
     private _buttonEl;
     private _popoverEl;
     private _model;

package/lib/types/elements/gtk-notebook.d.ts

@@ -1,3 +1,4 @@
+import { WidgetElement } from '../widget-element.js';
 /** `GtkPositionType`, spelled as the GIR's enum nicks. `top` is the property default. */
 export type NotebookTabPos = 'top' | 'bottom' | 'left' | 'right';
 /** The browser's page descriptor — the stand-in for the `GtkNotebookPage` GObject. */
@@ -19,7 +20,7 @@ export interface NotebookPageInfo {
     /** `GtkNotebookPage:child`. */
     child: HTMLElement;
 }
-export declare class GtkNotebook extends HTMLElement {
+export declare class GtkNotebook extends WidgetElement {
     private _current;
     private _initialized;
     private _initializedChildren;

package/lib/types/elements/gtk-overlay.d.ts

@@ -1,4 +1,5 @@
-export declare class GtkOverlay extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkOverlay extends WidgetElement {
     private _childEl;
     private _layerEl;
     private _initialized;

package/lib/types/elements/gtk-paned.d.ts

@@ -1,4 +1,5 @@
 import { type BoxOrientation } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** The inputs of `gtk_paned_compute_position`, one per field it reads. */
 export interface PanedPositionInput {
     /** The paned's own allocation along the axis, minus the handle — its `allocation`. */
@@ -33,7 +34,7 @@ export interface PanedPosition {
  * of inputs can hold.
  */
 export declare function computePanedPosition(input: PanedPositionInput): PanedPosition;
-export declare class GtkPaned extends HTMLElement {
+export declare class GtkPaned extends WidgetElement {
     private _startEl;
     private _handleEl;
     private _endEl;

package/lib/types/elements/gtk-picture.d.ts

@@ -1,3 +1,4 @@
+import { WidgetElement } from '../widget-element.js';
 /** `GtkContentFit`, in enum order — the four nicks the GIR and CSS share. */
 export declare const PICTURE_CONTENT_FIT_MODES: readonly ["fill", "contain", "cover", "scale-down"];
 export type PictureContentFit = (typeof PICTURE_CONTENT_FIT_MODES)[number];
@@ -9,7 +10,7 @@ export declare const DEFAULT_PICTURE_CONTENT_FIT: PictureContentFit;
  * distort every picture a page writes.
  */
 export declare function normalizePictureContentFit(value: unknown): PictureContentFit;
-export declare class GtkPicture extends HTMLElement {
+export declare class GtkPicture extends WidgetElement {
     private _initialized;
     static get observedAttributes(): string[];
     /**