@gjsify/adwaita-web 0.64.0 → 0.64.1-next.241

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

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

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

@@ -1,4 +1,5 @@
 import type { BottomSheetCloseOutcome, BottomSheetCloseSource, BottomSheetOpenOutcome, BottomSheetOpenSource } from '@gjsify/adwaita-core';
+import type { DispatchedSignals } from '../signals.js';
 /** The persistent content. Child of <adw-bottom-sheet>; consumed at connect time. */
 export declare class AdwBottomSheetContent extends HTMLElement {
 }
@@ -9,6 +10,8 @@ export declare class AdwBottomSheetSheet extends HTMLElement {
 export declare class AdwBottomSheetBottomBar extends HTMLElement {
 }
 export declare class AdwBottomSheet extends HTMLElement {
+    /** The GTK signals this element dispatches, each with the DOM event it arrives as (ADR 0093). */
+    static readonly signals: DispatchedSignals;
     private _initialized;
     private _contentEl;
     private _dimmingEl;

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

@@ -1,3 +1,4 @@
+import type { DispatchedSignals } from '../signals.js';
 /** A single navigation page. Children of <adw-navigation-view>. */
 export declare class AdwNavigationPage extends HTMLElement {
     /** Set while the owning view writes an attribute back, so the sync cannot recurse. */
@@ -15,6 +16,8 @@ export declare class AdwNavigationPage extends HTMLElement {
     revertAttribute(name: string, value: string | null): void;
 }
 export declare class AdwNavigationView extends HTMLElement {
+    /** The GTK signals this element dispatches, each with the DOM event it arrives as (ADR 0093). */
+    static readonly signals: DispatchedSignals;
     private _pagesEl;
     private readonly _backButtons;
     private _initialized;
@@ -28,6 +31,8 @@ export declare class AdwNavigationView extends HTMLElement {
     set popOnEscape(value: boolean);
     get visiblePage(): AdwNavigationPage | null;
     get visiblePageTag(): string | null;
+    /** `adw_navigation_view_get_visible_page_tag`. */
+    get_visible_page_tag(): string | null;
     get depth(): number;
     /** The navigation stack, bottom-first (Adw.NavigationView:navigation-stack). */
     get navigationStack(): readonly AdwNavigationPage[];
@@ -64,6 +69,8 @@ export declare class AdwNavigationView extends HTMLElement {
      * destroyed when it is popped.
      */
     push(pageOrTag: AdwNavigationPage | string): boolean;
+    /** `adw_navigation_view_push_by_tag`, under the name a GJS caller uses. */
+    push_by_tag(tag: string): boolean;
     /** Push the page carrying `tag` (mirrors AdwNavigationView.push_by_tag). */
     pushByTag(tag: string): boolean;
     /**

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

@@ -1,5 +1,8 @@
+import type { DispatchedSignals } from '../signals.js';
 import './gtk-switch.js';
 export declare class AdwSwitchRow extends HTMLElement {
+    /** The GTK signals this element dispatches, each with the DOM event it arrives as (ADR 0093). */
+    static readonly signals: DispatchedSignals;
     private _switchEl;
     private _prefixEl;
     /** The label column — kept for `tooltip-text`, which the browser reads off a PART. */

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

@@ -34,6 +34,11 @@ export declare class AdwWindowFeatures {
      */
     bind(): void;
     release(): void;
-    /** The window's size request — GTK's, not CSS's, so an absent attribute means the default. */
+    /**
+     * The window's size. `Adw.Window` defaults to a 360×200 MINIMUM (a size request, not the
+     * size; `width-request`/`height-request` override it). `default-width/height` is only
+     * a default: an authored size is the box, and an absent one leaves the box to the
+     * stylesheet, which fills the viewport — a page has no window manager to pick a size.
+     */
     applySizeRequest(): void;
 }

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

@@ -1,5 +1,6 @@
 import type { ActionLike } from '@gjsify/adwaita-core';
 import type { GtkApplication } from '../application.js';
+import type { DispatchedSignals } from '../signals.js';
 import type { AdwSlot } from '../slotted-children.js';
 import { GtkWindow } from './gtk-window.js';
 export declare class GtkApplicationWindow extends GtkWindow {
@@ -13,6 +14,7 @@ export declare class GtkApplicationWindow extends GtkWindow {
     remove_action: (name: string) => void;
     private _menubar;
     private _menubarObserver;
+    static readonly signals: DispatchedSignals;
     static get observedAttributes(): string[];
     /** `Gtk.ApplicationWindow:show-menubar` — whether the window shows a menubar of its own. */
     get showMenubar(): boolean;

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

@@ -1,3 +1,4 @@
+import type { DispatchedSignals } from '../signals.js';
 import { type AdwSlot } from '../slotted-children.js';
 import './gtk-window-controls.js';
 export declare class GtkWindow extends HTMLElement {
@@ -19,6 +20,25 @@ export declare class GtkWindow extends HTMLElement {
     private readonly _syncActive;
     private readonly _onFocusIn;
     private readonly _onFocusOut;
+    /**
+     * The GObject door (ADR 0096 § 3): `connect` / `disconnect` / `emit` / `notify` / `get_property` /
+     * `set_property` over these events, the same ones every element declares in `static signals`.
+     * A `close-request` handler that returns true is `preventDefault()`.
+     */
+    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`; `close-request` is refused, call `close()`. */
+    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`; a read-only property throws. */
+    set_property: (name: string, value: unknown) => void;
+    constructor();
     static get observedAttributes(): string[];
     /**
      * `Gtk.Window:title` — the window's title.
@@ -121,12 +141,18 @@ export declare class GtkWindow extends HTMLElement {
      * the window manager's to grant; a page owns no such surface, so this is only the first half.
      */
     present(): void;
-    /** `Gtk.Window:is-active` — see the header: the document's focus, while this frame is shown. */
+    /**
+     * `Gtk.Window:is-active` — see the header: the document's focus, while this frame is shown.
+     * A PROPERTY, as in GJS and `@girs/gtk-4.0`: GTK 4 has no `gtk_window_is_active`, so
+     * `window.is_active` is the value and `window.is_active()` does not exist.
+     */
     get isActive(): boolean;
-    /** `gtk_window_is_active`. */
-    is_active(): boolean;
+    get is_active(): boolean;
     /** `Gtk.Window:focus-widget`, read live from the document. */
     get focusWidget(): Element | null;
+    /** `Gtk.Window:focus-widget` under its GJS spelling; writing it is `set_focus`. */
+    get focus_widget(): Element | null;
+    set focus_widget(widget: Element | null);
     /** `gtk_window_get_focus`: the element inside the frame that has focus, or `null`. */
     get_focus(): Element | null;
     /**