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

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[];
     /**

package/lib/types/elements/gtk-popover-bin.d.ts

@@ -1,7 +1,8 @@
 import type { AdwMenuActions, AdwMenuInput, AdwMenuModel } from '@gjsify/adwaita-core';
 import './gtk-popover-menu.js';
 import type { GtkPopoverMenu } from './gtk-popover-menu.js';
-export declare class GtkPopoverBin extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkPopoverBin extends WidgetElement {
     private _model;
     private _popover;
     private _actions;

package/lib/types/elements/gtk-popover-menu-bar.d.ts

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

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

@@ -38,6 +38,8 @@ export declare class GtkPopoverMenu extends GtkPopover {
      */
     get visibleSubmenu(): string;
     set visibleSubmenu(value: string);
+    /** The menu's own stack is the child (gtkpopovermenu.c `gtk_popover_menu_init`). */
+    protected takesChild(): boolean;
     connectedCallback(): void;
     attributeChangedCallback(name?: string, previous?: string | null, value?: string | null): void;
     /** `gtk_popover_menu_open_submenu` — switch to the named page. */

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

@@ -1,3 +1,4 @@
+import { WidgetElement } from '../widget-element.js';
 /** Which side of the anchor the surface sits on. */
 export type GtkPopoverPosition = 'bottom' | 'top' | 'start' | 'end';
 /** Which edge of the anchor the surface lines up with. */
@@ -11,7 +12,7 @@ export type GtkPopoverAlign = 'start' | 'end';
  * `GtkPopover` declares nothing.
  */
 export type GtkPopoverRole = 'menu' | 'listbox' | 'dialog';
-export declare class GtkPopover extends HTMLElement {
+export declare class GtkPopover extends WidgetElement {
     private readonly _state;
     private _anchor;
     private _initialized;
@@ -67,6 +68,11 @@ export declare class GtkPopover extends HTMLElement {
     /** Subscribe to open-state changes. Returns an unsubscribe function. */
     subscribe(listener: (open: boolean) => void): () => void;
     connectedCallback(): void;
+    /**
+     * Whether `Gtk.Popover:child` is the author's to set. A subclass that builds its own
+     * content (GtkPopoverMenu, GtkEmojiChooser) sets the child itself, as their C does.
+     */
+    protected takesChild(): boolean;
     private _buildOnce;
     disconnectedCallback(): void;
     /**

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

@@ -1,4 +1,5 @@
-export declare class GtkProgressBar extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkProgressBar extends WidgetElement {
     private _trough;
     private _progress;
     private _text;

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

@@ -1,7 +1,8 @@
+import { WidgetElement } from '../widget-element.js';
 /** Every `GtkRevealerTransitionType` nick, in GIR order. */
 declare const TRANSITION_TYPES: readonly ["none", "crossfade", "slide-right", "slide-left", "slide-up", "slide-down", "swing-right", "swing-left", "swing-up", "swing-down", "fade-slide-right", "fade-slide-left", "fade-slide-up", "fade-slide-down"];
 export type RevealerTransitionType = (typeof TRANSITION_TYPES)[number];
-export declare class GtkRevealer extends HTMLElement {
+export declare class GtkRevealer extends WidgetElement {
     private _clipEl;
     private _initialized;
     /** `current_pos` — 0 hidden, 1 shown. */

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

@@ -1,5 +1,6 @@
 import './gtk-popover.js';
-export declare class GtkScaleButton extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkScaleButton extends WidgetElement {
     private readonly _state;
     private _buttonEl;
     private _glyph;

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

@@ -1,4 +1,5 @@
 import type { AdwAdjustment, AdwAdjustmentInput, BoxOrientation } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** `Gtk.PositionType` nicks, as `GtkScale:value-pos` spells them. */
 declare const VALUE_POSITIONS: readonly ["left", "right", "top", "bottom"];
 /** `GtkScale:value-pos` in the order libadwaita lays the value out: default `top`. */
@@ -11,7 +12,7 @@ type ValuePosition = (typeof VALUE_POSITIONS)[number];
  * a different `digits` default, and reuses this rather than growing a second copy of it.
  */
 export declare function formatScaleValue(value: number, digits: number): string;
-export declare class GtkScale extends HTMLElement {
+export declare class GtkScale extends WidgetElement {
     /** The headless `Gtk.Adjustment`: the range, the clamp and the two signals (ADR 0004, ADR 0047). */
     private readonly _range;
     private _trough;

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

@@ -1,7 +1,8 @@
 import { type AdwAdjustment, type AdwAdjustmentInput, type BoxOrientation } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** `GtkScrollType`'s six kinds, which is what a `scroll-child` names. */
 export type GtkScrollType = 'step-backward' | 'step-forward' | 'page-backward' | 'page-forward' | 'start' | 'end';
-export declare class GtkScrollbar extends HTMLElement {
+export declare class GtkScrollbar extends WidgetElement {
     private _trough;
     private _slider;
     private _observer;

package/lib/types/elements/gtk-scrolled-window.d.ts

@@ -1,5 +1,6 @@
 import type { AdwAdjustment } from '@gjsify/adwaita-core';
 import type { GtkViewport } from './gtk-viewport.js';
+import { WidgetElement } from '../widget-element.js';
 /** `GtkPolicyType`'s four nicks; `automatic` is the pspec's default for both bars. */
 export type GtkPolicyType = 'always' | 'never' | 'automatic' | 'external';
 /** `GtkCornerType`'s four corners, `top-left` being the pspec's default. */
@@ -8,7 +9,7 @@ export type GtkCornerType = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-r
 export type GtkPositionType = 'left' | 'right' | 'top' | 'bottom';
 /** `Gtk.DirectionType`'s two, as `move-focus-out` names them. */
 export type GtkDirectionType = 'forward' | 'backward';
-export declare class GtkScrolledWindow extends HTMLElement {
+export declare class GtkScrolledWindow extends WidgetElement {
     private _viewport;
     private _bars;
     /** The size clamps `_writeSize` last wrote, which are the only ones it may clear. */

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

@@ -1,4 +1,5 @@
-export declare class GtkSearchBar extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkSearchBar extends WidgetElement {
     private _box;
     private _center;
     private _close;

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

@@ -1,5 +1,6 @@
 import { type BoxOrientation } from '@gjsify/adwaita-core';
-export declare class GtkSeparator extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkSeparator extends WidgetElement {
     static get observedAttributes(): string[];
     /** `GtkOrientable:orientation` — `horizontal` (the default) or `vertical`. */
     get orientation(): BoxOrientation;

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

@@ -1,7 +1,8 @@
 import type { AdwAdjustment, AdwAdjustmentInput } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** `Gtk.SpinButtonUpdatePolicy` nicks; `always` is the pspec default (gtkspinbutton.c:472-475). */
 declare const UPDATE_POLICIES: readonly ["always", "if-valid"];
-export declare class GtkSpinButton extends HTMLElement {
+export declare class GtkSpinButton extends WidgetElement {
     private readonly _range;
     private _input;
     private _down;

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

@@ -1,4 +1,5 @@
-export declare class GtkSpinner extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkSpinner extends WidgetElement {
     private _initialized;
     static get observedAttributes(): string[];
     /** `Gtk.Spinner:spinning` — whether the animation runs. Defaults to FALSE (:338-340). */

package/lib/types/elements/gtk-stack-page.d.ts

@@ -0,0 +1,29 @@
+import { WidgetElement } from '../widget-element.js';
+/** The attributes a record hands to its child on adoption — `GtkStackPage`'s string/boolean properties. */
+export declare const STACK_PAGE_ATTRIBUTES: readonly ["name", "title", "icon-name", "needs-attention", "use-underline"];
+export declare class GtkStackPage extends WidgetElement {
+    static get observedAttributes(): ("title" | "name" | "icon-name" | "use-underline" | "needs-attention")[];
+    /** `GtkStackPage:name` — what `visible-child-name` selects by. */
+    get name(): string;
+    set name(value: string | null);
+    /** `GtkStackPage:icon-name`. */
+    get iconName(): string | null;
+    set iconName(value: string | null);
+    /** `GtkStackPage:needs-attention`. */
+    get needsAttention(): boolean;
+    set needsAttention(value: boolean);
+    /** `GtkStackPage:use-underline`. */
+    get useUnderline(): boolean;
+    set useUnderline(value: boolean);
+    /** `GtkStackPage:visible` — `hidden`, as on the child the stack reads it from. */
+    get visible(): boolean;
+    set visible(value: boolean);
+    /** `GtkStackPage:child` — the element the stack shows for this page, while not yet adopted. */
+    get child(): HTMLElement | null;
+    connectedCallback(): void;
+}
+/**
+ * The one element a record holds: its `slot="child"` child or its only element child. A record
+ * with none, or with more than one, is refused by name — GtkStackPage has exactly one `child`.
+ */
+export declare function pageChildOf(page: HTMLElement): HTMLElement | null;

package/lib/types/elements/gtk-stack-sidebar.d.ts

@@ -1,5 +1,6 @@
 import type { GtkStack } from './gtk-stack.js';
-export declare class GtkStackSidebar extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkStackSidebar extends WidgetElement {
     private _stack;
     private _list;
     private _initialized;

package/lib/types/elements/gtk-stack-switcher.d.ts

@@ -1,6 +1,7 @@
 import { type BoxOrientation } from '@gjsify/adwaita-core';
 import type { GtkStack } from './gtk-stack.js';
-export declare class GtkStackSwitcher extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkStackSwitcher extends WidgetElement {
     private _stack;
     private _initialized;
     private _nodes;

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

@@ -1,4 +1,5 @@
 import type { DispatchedSignals } from '../signals.js';
+import { WidgetElement } from '../widget-element.js';
 /** `GtkStackTransitionType`, spelled as the GIR's enum nicks (gtkstack.c:95-121). */
 export type StackTransitionType = 'none' | 'crossfade' | 'slide-right' | 'slide-left' | 'slide-up' | 'slide-down' | 'slide-left-right' | 'slide-up-down' | 'over-up' | 'over-down' | 'over-left' | 'over-right' | 'under-up' | 'under-down' | 'under-left' | 'under-right' | 'over-up-down' | 'over-down-up' | 'over-left-right' | 'over-right-left' | 'rotate-left' | 'rotate-right' | 'rotate-left-right';
 /** The browser's page descriptor — the stand-in for the `GtkStackPage` GObject. */
@@ -18,7 +19,7 @@ export interface GtkStackPageInfo {
     /** `GtkStackPage:child`: the page's own node. */
     child: HTMLElement;
 }
-export declare class GtkStack extends HTMLElement {
+export declare class GtkStack extends WidgetElement {
     /** The GTK signals this element dispatches, each with the DOM event it arrives as (ADR 0093). */
     static readonly signals: DispatchedSignals;
     /** The child that is visible, or `null` — C's `priv->visible_child`. */
@@ -118,7 +119,18 @@ export declare class GtkStack extends HTMLElement {
     private _page;
     /** `set_visible_child`'s "pick first visible" scan (gtkstack.c:1437-1450). */
     private _firstVisible;
+    /**
+     * A `<gtk-stack-page>` record, adopted: its child takes the record's place and its properties
+     * as the attributes this element reads, the way `<adw-view-stack>` adopts a declared page.
+     * Any other child is already the page and is handed back as it is.
+     */
+    private _adopt;
     private _initChild;
+    /**
+     * The observer watches the subtree, so an attribute record can come from anything below a
+     * page; only a direct child is a page of THIS stack (a nested stack's pages are its own).
+     */
+    private _isPage;
     private _onChildMutations;
     /** C's NULL page name is an ABSENT attribute, not the empty string (gtkstack.c:2216). */
     private _nameOrNull;

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

@@ -1,5 +1,6 @@
 import type { DispatchedSignals } from '../signals.js';
-export declare class GtkSwitch extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkSwitch extends WidgetElement {
     /** The GTK signals this element dispatches, each with the DOM event it arrives as (ADR 0093). */
     static readonly signals: DispatchedSignals;
     private _input;

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

@@ -1,4 +1,5 @@
 import { type LabelJustification } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** `Gtk.WrapMode`'s four nicks, in enum order — Pango's enum, and the DEFAULT is `none`. */
 declare const WRAP_MODES: readonly ["none", "char", "word", "word-char"];
 type TextViewWrapMode = (typeof WRAP_MODES)[number];
@@ -9,7 +10,7 @@ export interface GtkTextBufferSubset {
     set_text(text: string, len?: number): void;
     get_text(): string;
 }
-export declare class GtkTextView extends HTMLElement {
+export declare class GtkTextView extends WidgetElement {
     private _area;
     private _initialized;
     static get observedAttributes(): string[];

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

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

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

@@ -1,5 +1,6 @@
 import { type AdwTreeExpanderLayout } from '@gjsify/adwaita-core';
-export declare class GtkTreeExpander extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkTreeExpander extends WidgetElement {
     private _ornaments;
     private _expandTimer;
     private _initialized;

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

@@ -1,3 +1,4 @@
+import { WidgetElement } from '../widget-element.js';
 /** The four overlay glyphs, in the order `update_overlay_icon` tests them (gtkvideo.c:626-646). */
 export type VideoOverlayIcon = 'media-eject-symbolic' | 'dialog-error-symbolic' | 'media-playlist-repeat-symbolic' | 'media-playback-start-symbolic';
 /**
@@ -14,7 +15,7 @@ export declare const ENDED_ICON = "media-playlist-repeat-symbolic";
 export declare const READY_ICON = "media-playback-start-symbolic";
 /** `gtk_video_reveal_controls`' timeout: 3 s (gtkvideo.c:130). */
 export declare const CONTROLS_HIDE_MS = 3000;
-export declare class GtkVideo extends HTMLElement {
+export declare class GtkVideo extends WidgetElement {
     private _initialized;
     private _overlayIcon;
     private _controlsRevealer;

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

@@ -1,8 +1,9 @@
 import { type AdwAdjustment } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** The two axes a scrollport reports numbers for, in the order GTK declares them. */
 declare const AXES: readonly ["horizontal", "vertical"];
 type Axis = (typeof AXES)[number];
-export declare class GtkViewport extends HTMLElement {
+export declare class GtkViewport extends WidgetElement {
     private _observer;
     private _watch;
     static get observedAttributes(): string[];

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

@@ -1,8 +1,9 @@
+import { WidgetElement } from '../widget-element.js';
 /** `Gtk.PackType`, spelled as the GIR's enum nicks (gtkwindowcontrols.c:68). */
 type PackSide = 'start' | 'end';
 /** What a press asks for: the `GtkActionable` action name minus its `window.` prefix. */
 export type WindowAction = 'minimize' | 'toggle-maximized' | 'close';
-export declare class GtkWindowControls extends HTMLElement {
+export declare class GtkWindowControls extends WidgetElement {
     private _initialized;
     private _empty;
     /** The frame this controls answers to, or `null` outside one (`:257-263`). */

package/lib/types/elements/gtk-window-handle.d.ts

@@ -1,8 +1,9 @@
+import { WidgetElement } from '../widget-element.js';
 /** `GtkTitlebarGesture`'s three gestures, as `perform_titlebar_action` decides them. */
 export type GtkTitlebarGesture = 'double-click' | 'middle-click' | 'right-click';
 /** The settings' own vocabulary, `none` included: "the compositor declined" is one. */
 export type GtkTitlebarAction = 'toggle-maximize' | 'lower' | 'minimize' | 'menu' | 'none';
-export declare class GtkWindowHandle extends HTMLElement {
+export declare class GtkWindowHandle extends WidgetElement {
     /** The gesture in progress, as `priv->drag_start_x` / `_y` are in the C. */
     private _drag;
     /**

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

@@ -1,7 +1,9 @@
+import { type GtkApplication } from '../application.js';
 import type { DispatchedSignals } from '../signals.js';
 import { type AdwSlot } from '../slotted-children.js';
 import './gtk-window-controls.js';
-export declare class GtkWindow extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class GtkWindow extends WidgetElement {
     private _initialized;
     /** The `titlebar` strip — `protected` so a subclass can place its own strips around it. */
     protected _titlebar: HTMLDivElement;
@@ -26,6 +28,10 @@ export declare class GtkWindow extends HTMLElement {
      * A `close-request` handler that returns true is `preventDefault()`.
      */
     static readonly signals: DispatchedSignals;
+    /** `Gtk.Window:application`: setting it is `add_window` (ADR 0098), set by `defineWindowApplication`. */
+    application: GtkApplication | null;
+    get_application: () => GtkApplication | null;
+    set_application: (application: GtkApplication | null) => void;
     /** `GObject.Object.connect`: installed per instance by `installElementApi`; refuses an undeclared signal. */
     connect: (signal: string, handler: (emitter: this, ...args: any[]) => unknown) => number;
     /** `GObject.Object.disconnect`: throws for an id that is not connected. */
@@ -55,6 +61,9 @@ export declare class GtkWindow extends HTMLElement {
     /** `Gtk.Window:maximized` — square corners and the restore glyph. */
     get maximized(): boolean;
     set maximized(value: boolean);
+    /** `Gtk.Window:fullscreened` — square corners, and the frame fills its containing block. */
+    get fullscreened(): boolean;
+    set fullscreened(value: boolean);
     /** `Gtk.Window:resizable` — whether the maximize button may appear. */
     get resizable(): boolean;
     set resizable(value: boolean);
@@ -112,7 +121,8 @@ export declare class GtkWindow extends HTMLElement {
     private _render;
     /**
      * The frame's box from `default-width` / `default-height`; an absent one clears it. A subclass
-     * with a size request of its own (`Adw.Window`'s 360×200) replaces this.
+     * with a size request of its own (`Adw.Window`'s 360×200) replaces this. A maximized or
+     * fullscreened frame carries no inline size: the skin fills its containing block.
      */
     protected renderFrameSize(): void;
     /**
@@ -170,4 +180,10 @@ export declare class GtkWindow extends HTMLElement {
     maximize(): void;
     /** `gtk_window_unmaximize`, with the same caveat as {@link maximize}. */
     unmaximize(): void;
+    /** `gtk_window_is_fullscreen`: the FRAME's state, like {@link is_maximized}. */
+    is_fullscreen(): boolean;
+    /** `gtk_window_fullscreen`; asynchronous in GTK, so the property is written directly. */
+    fullscreen(): void;
+    /** `gtk_window_unfullscreen`, with the same caveat as {@link fullscreen}. */
+    unfullscreen(): void;
 }