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

package/lib/types/accessible.d.ts

@@ -0,0 +1,8 @@
+/** The `accessibility { }` names a host forwards: `label` and `description`, as ARIA spells them. */
+export declare const FORWARDED_ARIA: readonly ["aria-label", "aria-description"];
+/**
+ * Copies the host's {@link FORWARDED_ARIA} attributes onto `control`, removing what the host
+ * no longer has. Returns whether the host named the control, so a caller with a fallback name
+ * of its own (an icon-only button) writes that only where the tree wrote none.
+ */
+export declare function forwardAccessibleName(host: Element, control: Element): boolean;

package/lib/types/application.d.ts

@@ -17,7 +17,7 @@ export declare class GtkApplication extends GtkApplication_base {
 export declare class AdwApplication extends GtkApplication {
 }
 /**
- * `Gtk.Window:application` and the window's `Gio.ActionMap` (`win.` actions) on an element class.
+ * `Gtk.Window:application`, `get_application()` and `set_application()` on a window element class.
  * Setting the property is `add_window`, as on GTK; setting it to `null` is `remove_window`.
  */
 export declare function defineWindowApplication(proto: object): void;

package/lib/types/child-slot.spec.d.ts

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

package/lib/types/compute-expand.d.ts

@@ -0,0 +1,5 @@
+export type ExpandOrientation = 'horizontal' | 'vertical';
+/** The value of an authored `hexpand` / `vexpand`: `""` is true, `"false"` false, absent unset. */
+export declare function explicitExpand(el: Element, orientation: ExpandOrientation): boolean | undefined;
+/** `gtk_widget_compute_expand (el, orientation)`. */
+export declare function computeExpand(el: Element, orientation: ExpandOrientation): boolean;

package/lib/types/compute-expand.spec.d.ts

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

package/lib/types/container-fill.spec.d.ts

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

package/lib/types/elements/adw-about-dialog.d.ts

@@ -1,4 +1,6 @@
-export declare class AdwAboutDialog extends HTMLElement {
+import './adw-toast-overlay.js';
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwAboutDialog extends WidgetElement {
     private _initialized;
     private _scrimEl;
     private _sheetEl;
@@ -10,7 +12,17 @@ export declare class AdwAboutDialog extends HTMLElement {
     private _designers;
     private _artists;
     private _documenters;
+    /** `add_link` rows, in order; `has_custom_links` latches with the first. */
+    private _links;
+    /**
+     * The What's New buffer. Only the two release-notes setters rebuild it, never
+     * `version` (`update_release_notes` is called from those two alone).
+     */
+    private _releaseNotesSegments;
+    private _toastOverlay;
     static get observedAttributes(): string[];
+    /** `adw_about_dialog_new_from_appdata`, refused by name. */
+    static new_from_appdata(_resourcePath: string, _releaseNotesVersion?: string | null): never;
     get applicationName(): string;
     set applicationName(value: string);
     get applicationIcon(): string;
@@ -33,6 +45,14 @@ export declare class AdwAboutDialog extends HTMLElement {
     set license(value: string);
     get licenseUrl(): string;
     set licenseUrl(value: string);
+    get releaseNotes(): string;
+    set releaseNotes(value: string);
+    get releaseNotesVersion(): string;
+    set releaseNotesVersion(value: string);
+    get debugInfo(): string;
+    set debugInfo(value: string);
+    /** `adw_about_dialog_add_link`: a Details-page link row; `_` marks a mnemonic. */
+    add_link(title: string, url: string): void;
     get open(): boolean;
     set open(value: boolean);
     get developers(): string[];
@@ -85,6 +105,13 @@ export declare class AdwAboutDialog extends HTMLElement {
      */
     private _activateLink;
     private _buildDetailsPage;
+    /** The release-notes buffer as tagged runs, white space kept (a GtkTextView). */
+    private _buildWhatsNewPage;
+    private _buildTroubleshootingPage;
+    /** The debug text and Copy Text — the `about.copy-property` action on `debug-info`. */
+    private _buildDebugInfoPage;
+    /** `copy_property_cb`: an empty value copies nothing and shows no toast. */
+    private _copyProperty;
     private _buildLinkRow;
     private _buildCreditsPage;
     /**

package/lib/types/elements/adw-action-row.d.ts

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

package/lib/types/elements/adw-alert-dialog.d.ts

@@ -1,4 +1,6 @@
 import type { AdwResponseAppearance } from '@gjsify/adwaita-core';
+import type { DispatchedSignals } from '../signals.js';
+import { WidgetElement } from '../widget-element.js';
 /** Response button appearance — mirrors Adw.ResponseAppearance. */
 export type { AdwResponseAppearance } from '@gjsify/adwaita-core';
 /**
@@ -7,11 +9,42 @@ export type { AdwResponseAppearance } from '@gjsify/adwaita-core';
  * `appearance="suggested|destructive"` and `enabled="false"` mirror the
  * GtkBuildable `<response>` element attributes. Consumed at connect time.
  */
-export declare class AdwAlertResponse extends HTMLElement {
+export declare class AdwAlertResponse extends WidgetElement {
     static get observedAttributes(): string[];
 }
-export declare class AdwAlertDialog extends HTMLElement {
+/** The `Adw.AlertDialog` construct properties, in GJS's snake_case or the camelCase GJS also takes. */
+export interface AdwAlertDialogProps {
+    heading?: string;
+    body?: string;
+    heading_use_markup?: boolean;
+    headingUseMarkup?: boolean;
+    body_use_markup?: boolean;
+    bodyUseMarkup?: boolean;
+    close_response?: string;
+    closeResponse?: string;
+    default_response?: string | null;
+    defaultResponse?: string | null;
+    prefer_wide_layout?: boolean;
+    preferWideLayout?: boolean;
+}
+export declare class AdwAlertDialog extends WidgetElement {
+    /** The GTK signals this element dispatches, each with the DOM event it arrives as (ADR 0093). */
+    static readonly signals: DispatchedSignals;
+    /** `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. */
+    disconnect: (id: number) => void;
+    /** `GObject.Object.emit`. */
+    emit: (signal: string, ...args: unknown[]) => void;
+    /** `GObject.Object.notify`. */
+    notify: (name: string) => void;
+    /** `GObject.Object.get_property`, by GTK's dashed name. */
+    get_property: (name: string) => unknown;
+    /** `GObject.Object.set_property`. */
+    set_property: (name: string, value: unknown) => void;
     private _initialized;
+    /** Set when `present()` attached the dialog, so closing detaches it again. */
+    private _attachedByPresent;
     private _scrimEl;
     private _dialogEl;
     private _headingEl;
@@ -24,6 +57,12 @@ export declare class AdwAlertDialog extends HTMLElement {
     /** The rendered button per registered response id (the DOM half of the model). */
     private readonly _buttons;
     private _blockCloseResponse;
+    /**
+     * `new Adw.AlertDialog({ heading, body, close_response, default_response })`, the GJS
+     * construct bag. Only the `new` form passes one: `document.createElement` and the
+     * parser call this with nothing, which is why writing attributes here is allowed.
+     */
+    constructor(props?: AdwAlertDialogProps);
     static get observedAttributes(): string[];
     get heading(): string;
     set heading(value: string);
@@ -54,24 +93,46 @@ export declare class AdwAlertDialog extends HTMLElement {
      */
     private _adoptResponse;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
-    /** Present the dialog. `parent` is accepted for API parity; unused. */
+    /**
+     * Present the dialog (`adw_dialog_present`). A detached dialog is attached to the document
+     * first and detached again when it closes; `parent` names the window it belongs to, and the
+     * page is that window's root here, so it does not change where the dialog goes.
+     */
     present(_parent?: unknown): void;
-    addResponse(id: string, label: string): void;
-    /** Adds multiple responses at once — id/label pairs (Adw.add_responses parity). */
-    addResponses(...idLabelPairs: string[]): void;
-    removeResponse(id: string): void;
-    hasResponse(id: string): boolean;
-    getResponseLabel(id: string): string | null;
-    setResponseLabel(id: string, label: string): void;
-    getResponseAppearance(id: string): AdwResponseAppearance | null;
-    setResponseAppearance(id: string, appearance: AdwResponseAppearance): void;
-    getResponseEnabled(id: string): boolean;
-    /** Sets whether a response is enabled (disabled buttons can't be activated). */
-    setResponseEnabled(id: string, enabled: boolean): void;
-    /** Sets the default response — its button is highlighted as the suggested one. */
-    setDefaultResponse(id: string | null): void;
-    /** Sets the close response — emitted on dismissal (Escape / scrim click). */
-    setCloseResponse(id: string): void;
+    /** `adw_alert_dialog_add_response`: a duplicate id is refused, as libadwaita's g_critical does. */
+    add_response(id: string, label: string): void;
+    /** `adw_alert_dialog_remove_response`. */
+    remove_response(id: string): void;
+    /** `adw_alert_dialog_has_response`. */
+    has_response(id: string): boolean;
+    /** `adw_alert_dialog_get_response_label`; `null` for an unknown id, as the C returns NULL. */
+    get_response_label(id: string): string | null;
+    /** `adw_alert_dialog_set_response_label`. */
+    set_response_label(id: string, label: string): void;
+    /** `adw_alert_dialog_get_response_appearance`; `null` for an unknown id. */
+    get_response_appearance(id: string): AdwResponseAppearance | null;
+    /** `adw_alert_dialog_set_response_appearance`. */
+    set_response_appearance(id: string, appearance: AdwResponseAppearance): void;
+    /** `adw_alert_dialog_get_response_enabled`; `false` for an unknown id, as the C returns FALSE. */
+    get_response_enabled(id: string): boolean;
+    /** `adw_alert_dialog_set_response_enabled`: a disabled button cannot be activated. */
+    set_response_enabled(id: string, enabled: boolean): void;
+    /** `adw_alert_dialog_get_default_response`. */
+    get_default_response(): string | null;
+    /** `adw_alert_dialog_set_default_response`: its button is highlighted and takes the focus. */
+    set_default_response(id: string | null): void;
+    /** `adw_alert_dialog_get_close_response`. */
+    get_close_response(): string;
+    /** `adw_alert_dialog_set_close_response`: emitted on dismissal (Escape / scrim click). */
+    set_close_response(id: string): void;
+    /** `adw_alert_dialog_get_heading`. */
+    get_heading(): string;
+    /** `adw_alert_dialog_set_heading`. */
+    set_heading(heading: string): void;
+    /** `adw_alert_dialog_get_body`. */
+    get_body(): string;
+    /** `adw_alert_dialog_set_body`. */
+    set_body(body: string): void;
     private _activateResponse;
     /** Dismissal (Escape / scrim) — close, then emit the close-response. */
     private _dismiss;

package/lib/types/elements/adw-avatar.d.ts

@@ -1,4 +1,5 @@
-export declare class AdwAvatar extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwAvatar extends WidgetElement {
     private _textEl;
     private _iconEl;
     private _imageEl;

package/lib/types/elements/adw-banner.d.ts

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

package/lib/types/elements/adw-bin.d.ts

@@ -1,4 +1,5 @@
-export declare class AdwBin extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwBin extends WidgetElement {
     private _observer;
     /** `Adw.Bin:child` — the one child, or `null`. The last one appended is the one that stays. */
     get child(): Element | null;

package/lib/types/elements/adw-bottom-sheet.d.ts

@@ -1,15 +1,16 @@
 import type { BottomSheetCloseOutcome, BottomSheetCloseSource, BottomSheetOpenOutcome, BottomSheetOpenSource } from '@gjsify/adwaita-core';
 import type { DispatchedSignals } from '../signals.js';
+import { WidgetElement } from '../widget-element.js';
 /** The persistent content. Child of <adw-bottom-sheet>; consumed at connect time. */
-export declare class AdwBottomSheetContent extends HTMLElement {
+export declare class AdwBottomSheetContent extends WidgetElement {
 }
 /** The slide-up sheet. Child of <adw-bottom-sheet>; consumed at connect time. */
-export declare class AdwBottomSheetSheet extends HTMLElement {
+export declare class AdwBottomSheetSheet extends WidgetElement {
 }
 /** The collapsed bar the sheet morphs out of. Child of <adw-bottom-sheet>. */
-export declare class AdwBottomSheetBottomBar extends HTMLElement {
+export declare class AdwBottomSheetBottomBar extends WidgetElement {
 }
-export declare class AdwBottomSheet extends HTMLElement {
+export declare class AdwBottomSheet extends WidgetElement {
     /** The GTK signals this element dispatches, each with the DOM event it arrives as (ADR 0093). */
     static readonly signals: DispatchedSignals;
     private _initialized;

package/lib/types/elements/adw-breakpoint-bin.d.ts

@@ -1,4 +1,5 @@
-export declare class AdwBreakpointBin extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwBreakpointBin extends WidgetElement {
     /** The C's own structure: a list of breakpoints, and at most one picked. */
     private _state;
     private _dispose;

package/lib/types/elements/adw-button-content.d.ts

@@ -1,4 +1,5 @@
-export declare class AdwButtonContent extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwButtonContent extends WidgetElement {
     private _boxEl;
     private _iconEl;
     private _labelEl;

package/lib/types/elements/adw-button-row.d.ts

@@ -1,4 +1,5 @@
-export declare class AdwButtonRow extends HTMLElement {
+import { TooltipElement } from '../widget-element.js';
+export declare class AdwButtonRow extends TooltipElement {
     private _contentsEl;
     private _startIconEl;
     private _endIconEl;

package/lib/types/elements/adw-card.d.ts

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

package/lib/types/elements/adw-carousel.d.ts

@@ -1,5 +1,6 @@
+import { WidgetElement } from '../widget-element.js';
 /** Common surface an indicator binds to. The concrete element is AdwCarousel. */
-interface CarouselHost extends HTMLElement {
+interface CarouselHost extends WidgetElement {
     readonly nPages: number;
     readonly position: number;
     /** The page the current position settles on, `-1` when empty. */
@@ -8,7 +9,7 @@ interface CarouselHost extends HTMLElement {
     addEventListener(type: string, listener: EventListenerOrEventListenerObject): void;
     removeEventListener(type: string, listener: EventListenerOrEventListenerObject): void;
 }
-export declare class AdwCarousel extends HTMLElement implements CarouselHost {
+export declare class AdwCarousel extends WidgetElement implements CarouselHost {
     private readonly _state;
     private _trackEl;
     /** Page id → its `.adw-carousel-page` slot. Ids are internal; the DOM node is the public handle. */
@@ -36,6 +37,8 @@ export declare class AdwCarousel extends HTMLElement implements CarouselHost {
     private _scrollTargetId;
     /** The pointer-drag gesture, asked whether it owns the strip. See `_onWheel`. */
     private _drag;
+    /** A `scroll_to` issued before the pages were adopted, run once they are. */
+    private _pendingScrollPage;
     static get observedAttributes(): string[];
     constructor();
     get nPages(): number;
@@ -115,6 +118,20 @@ export declare class AdwCarousel extends HTMLElement implements CarouselHost {
     scrollToPage(index: number): void;
     /** One keynav step — `navigate_to_direction`. */
     navigate(direction: 'back' | 'forward'): boolean;
+    /**
+     * `adw_carousel_scroll_to` — scroll to `widget`, one of the pages. A widget that is
+     * not one is refused, which is C's precondition; `animate = false` lands at once.
+     */
+    scroll_to(widget: HTMLElement, animate: boolean): void;
+    /**
+     * `adw_carousel_get_nth_page` — the page at `n`. Past the last page C's precondition
+     * fails and returns NULL, so this returns `null`.
+     */
+    get_nth_page(n: number): HTMLElement | null;
+    /** `adw_carousel_get_n_pages`. */
+    get_n_pages(): number;
+    /** `adw_carousel_get_position` — the {@link position} property. */
+    get_position(): number;
     private _insert;
     private _idOf;
     private _syncTrack;
@@ -173,7 +190,7 @@ export declare class AdwCarousel extends HTMLElement implements CarouselHost {
     private _updatePositionFromScroll;
     private _onStateChange;
 }
-declare abstract class AdwCarouselIndicator extends HTMLElement {
+declare abstract class AdwCarouselIndicator extends WidgetElement {
     protected _carousel: CarouselHost | null;
     protected _initialized: boolean;
     static get observedAttributes(): string[];

package/lib/types/elements/adw-clamp-scrollable.d.ts

@@ -1,7 +1,8 @@
 import { type AdwLengthUnit, type BoxOrientation } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** `Gtk.ScrollablePolicy`'s three nicks, in enum order. */
 export type ScrollPolicy = 'automatic' | 'always' | 'never';
-export declare class AdwClampScrollable extends HTMLElement {
+export declare class AdwClampScrollable extends WidgetElement {
     private _resize;
     private _mutations;
     static get observedAttributes(): string[];

package/lib/types/elements/adw-clamp.d.ts

@@ -1,4 +1,5 @@
-export declare class AdwClamp extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwClamp extends WidgetElement {
     private _resize;
     private _mutations;
     static get observedAttributes(): string[];

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

@@ -1,5 +1,6 @@
 import type { AdwComboOption, AdwListModelInput } from '@gjsify/adwaita-core';
-export declare class AdwComboRow extends HTMLElement {
+import { TooltipElement } from '../widget-element.js';
+export declare class AdwComboRow extends TooltipElement {
     private _select;
     private _valueEl;
     /** The label column — kept for `tooltip-text`, which the browser reads off a PART. */
@@ -13,6 +14,8 @@ export declare class AdwComboRow extends HTMLElement {
     /** The list model (`Adw.ComboRow:model`). Setting it splices the <select> and clamps the selection. */
     get model(): AdwComboOption[];
     set model(value: AdwListModelInput);
+    /** `adw_combo_row_set_model`. */
+    set_model(model: AdwListModelInput | null): void;
     /**
      * The selected index (Adw.ComboRow:selected). PERMISSIVE: an index past the end is
      * accepted and reads back with an empty {@link selectedValue}, mirroring the `guint`
@@ -22,6 +25,8 @@ export declare class AdwComboRow extends HTMLElement {
      */
     get selected(): number;
     set selected(value: number);
+    get_selected(): number;
+    set_selected(position: number): void;
     /**
      * The selected option's `value`, or '' when nothing is selected (Adw.ComboRow:selected-item).
      *

package/lib/types/elements/adw-data-grid.d.ts

@@ -1,6 +1,7 @@
 import type { AdwDataGridColumn, AdwDataGridRow } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 export type { AdwDataGridAlign, AdwDataGridCellValue, AdwDataGridColumn, AdwDataGridRow, AdwDataGridRowVariant, } from '@gjsify/adwaita-core';
-export declare class AdwDataGrid extends HTMLElement {
+export declare class AdwDataGrid extends WidgetElement {
     private _captionEl;
     private _scrollEl;
     private _tableEl;

package/lib/types/elements/adw-dialog.d.ts

@@ -1,6 +1,7 @@
+import { WidgetElement } from '../widget-element.js';
 /** Adaptive presentation of the dialog — mirrors Adw.DialogPresentationMode. */
 export type AdwDialogPresentationMode = 'auto' | 'floating' | 'bottom-sheet';
-export declare class AdwDialog extends HTMLElement {
+export declare class AdwDialog extends WidgetElement {
     private _initialized;
     private _scrimEl;
     private _boxEl;

package/lib/types/elements/adw-entry-row.d.ts

@@ -1,6 +1,7 @@
 import { EntryRowState, type EntryRowRenderState } from '@gjsify/adwaita-core';
 import { type GtkImage } from './gtk-image.js';
-export declare class AdwEntryRow extends HTMLElement {
+import { TooltipElement } from '../widget-element.js';
+export declare class AdwEntryRow extends TooltipElement {
     /** The headless `update_empty` derivation + apply latch (ADR 0004). */
     protected readonly _state: EntryRowState;
     protected _input: HTMLInputElement;

package/lib/types/elements/adw-expander-row.d.ts

@@ -1,5 +1,6 @@
 import './gtk-switch.js';
-export declare class AdwExpanderRow extends HTMLElement {
+import { TooltipElement } from '../widget-element.js';
+export declare class AdwExpanderRow extends TooltipElement {
     private _headerEl;
     private _titleEl;
     private _subtitleEl;

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

@@ -1,5 +1,6 @@
 import './adw-window-title.js';
-export declare class AdwHeaderBar extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwHeaderBar extends WidgetElement {
     private _initialized;
     private _startEl;
     private _centerEl;

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

@@ -1,11 +1,12 @@
 import type { ViewSwitcherScheduler } from '@gjsify/adwaita-core';
 import type { AdwInlineViewSwitcherDisplayMode, AdwViewSwitcherPage } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** A single page. Children of <adw-inline-view-switcher>; consumed at connect time. */
-export declare class AdwViewStackPage extends HTMLElement {
+export declare class AdwViewStackPage extends WidgetElement {
     static get observedAttributes(): string[];
     connectedCallback(): void;
 }
-export declare class AdwInlineViewSwitcher extends HTMLElement {
+export declare class AdwInlineViewSwitcher extends WidgetElement {
     /**
      * The dwell timer, injectable: a property rather than an inline
      * `new ViewSwitcherState({ scheduler: domViewSwitcherScheduler })`, so a test can

package/lib/types/elements/adw-layout-slot.d.ts

@@ -1,4 +1,5 @@
-export declare class AdwLayoutSlot extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwLayoutSlot extends WidgetElement {
     private _registered;
     static get observedAttributes(): string[];
     /** `adw_layout_slot_get_slot_id()` (:184), read under its property's name. */

package/lib/types/elements/adw-multi-layout-view.d.ts

@@ -1,5 +1,6 @@
 import type { AdwLayoutSlot } from './adw-layout-slot.js';
-export declare class AdwMultiLayoutView extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwMultiLayoutView extends WidgetElement {
     /** The C's own tables: layouts in order, children by id, and the current layout. */
     private _layouts;
     private _children;

package/lib/types/elements/adw-navigation-split-view.d.ts

@@ -1,4 +1,5 @@
 import { type AdwPackType, type NavigationActionResult } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /** Detail of the `navigation-push` / `navigation-pop` delegation event. */
 export interface NavigationDelegateDetail {
     /** The tag a `push` names; absent for a `pop`. */
@@ -6,7 +7,7 @@ export interface NavigationDelegateDetail {
     /** Set by an ancestor that handled it — the `return TRUE` of the C's routing. */
     handled: boolean;
 }
-export declare class AdwNavigationSplitView extends HTMLElement {
+export declare class AdwNavigationSplitView extends WidgetElement {
     private _sidebarEl;
     private _contentEl;
     private _initialized;

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

@@ -1,6 +1,7 @@
 import type { DispatchedSignals } from '../signals.js';
+import { WidgetElement } from '../widget-element.js';
 /** A single navigation page. Children of <adw-navigation-view>. */
-export declare class AdwNavigationPage extends HTMLElement {
+export declare class AdwNavigationPage extends WidgetElement {
     /** Set while the owning view writes an attribute back, so the sync cannot recurse. */
     private _syncing;
     static get observedAttributes(): string[];
@@ -15,7 +16,7 @@ export declare class AdwNavigationPage extends HTMLElement {
     attributeChangedCallback(name: string, previous: string | null): void;
     revertAttribute(name: string, value: string | null): void;
 }
-export declare class AdwNavigationView extends HTMLElement {
+export declare class AdwNavigationView extends WidgetElement {
     /** The GTK signals this element dispatches, each with the DOM event it arrives as (ADR 0093). */
     static readonly signals: DispatchedSignals;
     private _pagesEl;

package/lib/types/elements/adw-overlay-split-view.d.ts

@@ -1,5 +1,6 @@
 import type { DispatchedSignals } from '../signals.js';
-export declare class AdwOverlaySplitView extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwOverlaySplitView extends WidgetElement {
     /** The GTK signals this element dispatches, which is what a `.blp` `bind` of `show-sidebar` follows. */
     static readonly signals: DispatchedSignals;
     private _initialized;

package/lib/types/elements/adw-preferences-dialog.d.ts

@@ -1,4 +1,5 @@
 import type { PreferencesSearchResult, SearchPreferencesOptions } from '@gjsify/adwaita-core';
+import { WidgetElement } from '../widget-element.js';
 /**
  * A single preferences page (Adw.PreferencesPage), child of <adw-preferences-dialog>.
  *
@@ -7,7 +8,7 @@ import type { PreferencesSearchResult, SearchPreferencesOptions } from '@gjsify/
  * / name / use-underline / visible onto the view-stack page, and
  * `create_search_row_subtitle` needs the title back the moment a second page is visible.
  */
-export declare class AdwPreferencesPage extends HTMLElement {
+export declare class AdwPreferencesPage extends WidgetElement {
     static get observedAttributes(): string[];
     /** `adw_preferences_page_get_name` — the view-stack child name. */
     get name(): string;
@@ -20,7 +21,7 @@ export declare class AdwPreferencesPage extends HTMLElement {
     set useUnderline(value: boolean);
     get groups(): HTMLElement[];
 }
-export declare class AdwPreferencesDialog extends HTMLElement {
+export declare class AdwPreferencesDialog extends WidgetElement {
     private _initialized;
     private _scrimEl;
     private _dialogEl;
@@ -38,8 +39,8 @@ export declare class AdwPreferencesDialog extends HTMLElement {
     /** The dialog's preferred content width in px (Adw.Dialog:content-width). */
     get contentWidth(): number;
     set contentWidth(value: number);
-    /** Reveal the dialog (mirrors Adw.Dialog.present). */
-    present(): void;
+    /** Reveal the dialog (mirrors Adw.Dialog.present). Auto-attaches if disconnected. */
+    present(parent?: Element): void;
     /** Dismiss the dialog, respecting `can-close` (mirrors Adw.Dialog.close). */
     close(): void;
     /** Dismiss the dialog regardless of `can-close` (mirrors Adw.Dialog.force_close). */

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

@@ -1,4 +1,5 @@
-export declare class AdwPreferencesGroup extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwPreferencesGroup extends WidgetElement {
     private _headerEl;
     private _titleEl;
     private _descriptionEl;

package/lib/types/elements/adw-preferences-row.d.ts

@@ -1,4 +1,5 @@
-export declare class AdwPreferencesRow extends HTMLElement {
+import { TooltipElement } from '../widget-element.js';
+export declare class AdwPreferencesRow extends TooltipElement {
     private _titleEl;
     private _contentEl;
     private _initialized;

package/lib/types/elements/adw-shortcut-label.d.ts

@@ -1,4 +1,5 @@
-export declare class AdwShortcutLabel extends HTMLElement {
+import { WidgetElement } from '../widget-element.js';
+export declare class AdwShortcutLabel extends WidgetElement {
     private _initialized;
     static get observedAttributes(): string[];
     connectedCallback(): void;

package/lib/types/elements/adw-shortcuts-item.d.ts

@@ -1,3 +1,4 @@
+import { WidgetElement } from '../widget-element.js';
 /**
  * `AdwShortcutsItem:direction` is a `GtkTextDirection`, so it carries `none` beside the
  * two directions — and `none` is the default, meaning "show this row either way".
@@ -6,7 +7,7 @@
  * split-view.ts:41), which cannot hold the value the C defaults this property to.
  */
 export type AdwShortcutsItemDirection = 'ltr' | 'rtl' | 'none';
-export declare class AdwShortcutsItem extends HTMLElement {
+export declare class AdwShortcutsItem extends WidgetElement {
     private _initialized;
     private _titleEl;
     private _subtitleEl;

package/lib/types/elements/adw-shortcuts-section.d.ts

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