@gjsify/adwaita-web 0.64.11 → 0.64.12-next.280

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

@@ -30,14 +30,6 @@ export interface AdwAlertDialogProps {
 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`. */

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

@@ -39,6 +39,11 @@ export declare class AdwOverlaySplitView extends WidgetElement {
     static get observedAttributes(): string[];
     get showSidebar(): boolean;
     set showSidebar(v: boolean);
+    /** `Adw.OverlaySplitView:show-sidebar` — the GIR spelling of {@link showSidebar}. */
+    get show_sidebar(): boolean;
+    set show_sidebar(v: boolean);
+    get_show_sidebar(): boolean;
+    set_show_sidebar(v: boolean): void;
     get collapsed(): boolean;
     set collapsed(v: boolean);
     get minSidebarWidth(): number;

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

@@ -39,6 +39,26 @@ export declare class AdwViewStack extends WidgetElement {
      */
     add(content: HTMLElement, name: string, title?: string, icon?: string): AdwViewStackPageInfo;
     addTitled(content: HTMLElement, name: string, title: string): AdwViewStackPageInfo;
+    /** `adw_view_stack_add_titled`. */
+    add_titled(child: HTMLElement, name: string, title: string): AdwViewStackPageInfo;
+    /** `adw_view_stack_add_named`. */
+    add_named(child: HTMLElement, name: string | null): AdwViewStackPageInfo;
+    /** `adw_view_stack_add_titled_with_icon`: the same four values as {@link add}, in the same order. */
+    add_titled_with_icon(child: HTMLElement, name: string, title: string, iconName: string): AdwViewStackPageInfo;
+    /**
+     * `adw_view_stack_remove` takes the CHILD. With no argument this is still
+     * `ChildNode.remove()` — the element leaves its parent — because the GIR name and the
+     * DOM name share one spelling here.
+     */
+    remove(child?: HTMLElement): void;
+    /** `adw_view_stack_get_visible_child_name`. */
+    get_visible_child_name(): string | null;
+    /** `adw_view_stack_set_visible_child_name`. */
+    set_visible_child_name(name: string): void;
+    /** `adw_view_stack_get_visible_child`. */
+    get_visible_child(): HTMLElement | null;
+    /** `adw_view_stack_set_visible_child`; a child that is not a page of this stack selects nothing. */
+    set_visible_child(child: HTMLElement): void;
     /**
      * Remove the first page named `name` and detach its content. Returns whether
      * anything was removed. When the removed page was the visible one the stack

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

@@ -24,6 +24,10 @@ export declare class AdwViewSwitcherBar extends WidgetElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+    /** `adw_view_switcher_bar_set_stack` — the GIR spelling of {@link setStack}. */
+    set_stack(stack: AdwViewStack | null): void;
+    /** `adw_view_switcher_bar_get_stack`. */
+    get_stack(): AdwViewStack | null;
     /** Bind to a stack element (or null). Unbinds the previous one and rebuilds. */
     setStack(stack: AdwViewStack | null): void;
     /**

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

@@ -12,6 +12,22 @@ export declare class GtkBox extends WidgetElement {
     /** `Gtk.Box:homogeneous` — whether every child gets the same size along the axis. */
     get homogeneous(): boolean;
     set homogeneous(value: boolean);
+    /**
+     * `gtk_box_remove` under its GIR name. With no argument it stays `ChildNode.remove()`:
+     * the box leaves its own parent. A `child` that is not a direct child is where C warns
+     * (`g_warning ("Trying to remove a widget that is not a child")`) and does nothing.
+     */
+    remove(child?: Element): void;
+    /**
+     * `gtk_box_insert_child_after`. A NULL/absent `sibling` inserts at the FIRST position,
+     * not the last — `gtk_widget_insert_after`'s rule, pinned by
+     * `WRAP_BOX_CHILD_ORDER_VECTORS`. Returns whether the insert happened; a refusal is where
+     * C would have hit a `g_return_if_fail`.
+     */
+    insert_child_after(child: Element, sibling?: Element | null): boolean;
+    /** `gtk_box_reorder_child_after`. Same NULL rule. */
+    reorder_child_after(child: Element, sibling?: Element | null): boolean;
+    private _applyOrder;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, old: string | null, value: string | null): void;

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

@@ -20,6 +20,11 @@ export declare class GtkMenuButton extends WidgetElement {
      * note on the same setter.
      */
     set menuModel(value: AdwMenuInput);
+    /** `Gtk.MenuButton:menu-model` — the GIR spelling of {@link menuModel}. */
+    get menu_model(): AdwMenuModel;
+    set menu_model(value: AdwMenuInput);
+    get_menu_model(): AdwMenuModel;
+    set_menu_model(value: AdwMenuInput): void;
     /**
      * Normalise, REFUSE, store — the one door every menu comes through.
      *

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

@@ -21,6 +21,8 @@ export declare class GtkScrolledWindow extends WidgetElement {
     private _built;
     /** What an unbuilt window answers before it has a viewport to read. */
     private readonly _standIn;
+    private readonly _heard;
+    private _pushing;
     private readonly _adopted;
     static get observedAttributes(): string[];
     /** `GtkScrolledWindow:hscrollbar-policy` — `automatic` in the pspec. */
@@ -33,14 +35,25 @@ export declare class GtkScrolledWindow extends WidgetElement {
     get_policy(): [number, number];
     /** `gtk_scrolled_window_set_policy`; a value that is not a `Gtk.PolicyType` throws, as GJS's enum marshalling does. */
     set_policy(hscrollbar_policy: number, vscrollbar_policy: number): void;
-    /** `GtkScrollable:hadjustment` as the window reports it: the one it was given, else the viewport's. */
+    /**
+     * `GtkScrollable:hadjustment` as the window reports it: the one it was given, else its own.
+     *
+     * Either is ONE object for the window's life, observable like GTK's: the viewport's
+     * numbers are configured into it, and a write to its value scrolls the content.
+     */
     get hadjustment(): AdwAdjustment;
     get vadjustment(): AdwAdjustment;
     get_hadjustment(): AdwAdjustment;
     get_vadjustment(): AdwAdjustment;
-    /** Adopts `adjustment` as what `get_hadjustment` answers; the scroll position keeps following the viewport. */
+    /** Adopts `adjustment` as what `get_hadjustment` answers; it is kept in step with the viewport both ways. */
     set_hadjustment(adjustment: AdwAdjustment): void;
     set_vadjustment(adjustment: AdwAdjustment): void;
+    private _adjustmentOf;
+    private _adopt;
+    /** A write to the adjustment's value moves the scrollport; a plain object has no signal to hear. */
+    private _listen;
+    /** Configures the window's adjustment of one axis from the viewport's numbers. */
+    private _push;
     /** `GtkScrolledWindow:window-placement` — where the contents sit against the bars. */
     get windowPlacement(): GtkCornerType;
     set windowPlacement(value: GtkCornerType);

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

@@ -86,6 +86,23 @@ export declare class GtkStack extends WidgetElement {
      * `Adw.ViewStack.remove` took in `adw-view-stack.ts`.
      */
     removePage(child: HTMLElement): void;
+    /**
+     * `gtk_stack_remove` under its GIR name. With no argument it stays `ChildNode.remove()`:
+     * the stack leaves its own parent.
+     */
+    remove(child?: HTMLElement): void;
+    /** `gtk_stack_add_titled` under its GIR name. */
+    add_titled(child: HTMLElement, name: string | null, title: string | null): HTMLElement;
+    /** `gtk_stack_add_named` under its GIR name. */
+    add_named(child: HTMLElement, name: string | null): HTMLElement;
+    /** `gtk_stack_get_visible_child_name`. */
+    get_visible_child_name(): string | null;
+    /** `gtk_stack_set_visible_child_name`. */
+    set_visible_child_name(name: string): void;
+    /** `gtk_stack_get_visible_child`. */
+    get_visible_child(): HTMLElement | null;
+    /** `gtk_stack_set_visible_child`. */
+    set_visible_child(child: HTMLElement): void;
     /**
      * `gtk_stack_set_visible_child` (gtkstack.c:2244-2281), with `gtk_stack_set_visible_
      * child_full`'s per-call transition (gtkstack.c:2306-2334). A child that is not in

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

@@ -32,14 +32,6 @@ export declare class GtkWindow extends WidgetElement {
     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. */
-    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. */
@@ -70,6 +62,13 @@ export declare class GtkWindow extends WidgetElement {
     /** `Gtk.Window:deletable` — whether the close button may appear. */
     get deletable(): boolean;
     set deletable(value: boolean);
+    /** `Gtk.Window:hide-on-close` — `close()` hides the window instead of destroying it. */
+    get hide_on_close(): boolean;
+    set hide_on_close(value: boolean);
+    /** `gtk_window_get_hide_on_close`. */
+    get_hide_on_close(): boolean;
+    /** `gtk_window_set_hide_on_close`. */
+    set_hide_on_close(setting: boolean): void;
     /**
      * `setAttribute` for a write that changes nothing. Every GObject setter here returns
      * early when the value is already right (gtkwindow.c:1015-1017, :1045-1046, :894-895),
@@ -170,6 +169,13 @@ export declare class GtkWindow extends WidgetElement {
      * GTK's window only focuses its own descendants.
      */
     set_focus(widget: Element | null): void;
+    /** `gtk_window_get_default_size`: `[width, height]`, `[0, 0]` while neither attribute is set. */
+    get_default_size(): [number, number];
+    /**
+     * `gtk_window_set_default_size`: a value below -1 is refused (GTK's `g_return_if_fail`), an
+     * equal one does not notify, and `default-height` notifies before `default-width`.
+     */
+    set_default_size(width: number, height: number): void;
     /** `gtk_window_is_maximized`: the FRAME's state, not the browser window's. */
     is_maximized(): boolean;
     /**

package/lib/types/gobject-elements.d.ts

@@ -30,6 +30,8 @@ export declare function hasInstalledVisible(el: Element): boolean;
 export declare function installVisible(el: HTMLElement): void;
 /** Gives `el` the instance API of a registered class, over the events it declares. */
 export declare function installElementApi(el: HTMLElement): void;
+/** Marks the self-installing `connect` / `disconnect` / `emit` / `notify` of `proto` ({@link WidgetElement}). */
+export declare function markLazyElementApi(proto: object): void;
 /**
  * The end of a bind the core's engine drives. An element speaks camelCase members where a `.blp`
  * says `dash-name`, so a built element is wrapped to translate the name; a registered class

package/lib/types/gtksource/gtk-source-view.d.ts

@@ -17,6 +17,7 @@ export declare class GtkSourceView extends WidgetElement {
     private direction;
     private readonly gutters;
     constructor();
+    private syncing;
     private syncAdjustments;
     private readonly onAreaScroll;
     connectedCallback(): void;
@@ -74,7 +75,7 @@ export declare class GtkSourceView extends WidgetElement {
     get bottomMargin(): number;
     set bottomMargin(value: number | string);
     /** GJS `connect(name, cb) → id`; the handler's first argument is this view. */
-    connect(name: string, callback: (self: GtkSourceView, ...args: never[]) => unknown): number;
+    connect(name: string, callback: (self: this, ...args: never[]) => unknown): number;
     /** `g_signal_connect_after`: runs once the plain handlers and the default of the emission have run. */
     connect_after(name: string, callback: (self: GtkSourceView, ...args: never[]) => unknown): number;
     /** `GObject.signal_stop_emission_by_name(view, …)`: the session owns the emissions. */

package/lib/types/index.d.ts

@@ -13,6 +13,7 @@ export * as Adw from './namespace/adw.js';
 export * as Gtk from './namespace/gtk.js';
 export * as Gio from './namespace/gio.js';
 export * as Gdk from './namespace/gdk.js';
+export * as Graphene from './namespace/graphene.js';
 export * as GLib from './namespace/glib.js';
 export * as GObject from './namespace/gobject.js';
 export * as GtkSource from './namespace/gtksource.js';

package/lib/types/namespace/adw.d.ts

@@ -56,4 +56,4 @@ export { AdwWindowTitle as WindowTitle } from '../elements/adw-window-title.js';
 export { AdwWrapBox as WrapBox } from '../elements/adw-wrap-box.js';
 export { AdwApplication as Application } from '../application.js';
 export { AdwStyleManager as StyleManager } from '../style-manager.js';
-export { ColorScheme, Toast, ToastPriority } from '@gjsify/adwaita-core';
+export { AccentColor, ColorScheme, Toast, ToastPriority } from '@gjsify/adwaita-core';

package/lib/types/namespace/gdk.d.ts

@@ -1,3 +1,4 @@
+export { RGBA } from '@gjsify/adwaita-core';
 export declare const gdk: import("@gjsify/adwaita-core").GdkClipboard;
 export declare const Display: {
     get_default(): import("@gjsify/adwaita-core").Display;

package/lib/types/namespace/graphene.d.ts

@@ -0,0 +1,8 @@
+import { Point } from '@gjsify/adwaita-core';
+declare module '../widget-element.js' {
+    interface WidgetElement {
+        /** `gtk_widget_compute_point`: `[false, (0, 0)]` when the two share no tree. */
+        compute_point(target: WidgetElement, point: Point): [boolean, Point];
+    }
+}
+export { Point };

package/lib/types/widget-element.d.ts

@@ -9,6 +9,31 @@ export declare class WidgetElement extends HTMLElement {
     get_visible(): boolean;
     /** `gtk_widget_set_visible`. */
     set_visible(visible: boolean): void;
+    /** `gtk_widget_get_first_child`: the first child element, `null` for a leaf. */
+    get_first_child(): Element | null;
+    /** `gtk_widget_get_last_child`. */
+    get_last_child(): Element | null;
+    /** `gtk_widget_get_next_sibling`. */
+    get_next_sibling(): Element | null;
+    /** `gtk_widget_get_prev_sibling`. */
+    get_prev_sibling(): Element | null;
+    /** `gtk_widget_get_parent`. */
+    get_parent(): Element | null;
+    /** `gtk_widget_get_width`: the layout box in CSS px; 0 until the widget is rendered. */
+    get_width(): number;
+    /** `gtk_widget_get_height`: the layout box in CSS px; 0 until the widget is rendered. */
+    get_height(): number;
+    /**
+     * The GObject signal API (ADR 0096 § 3), over the events the element declares in `static signals`:
+     * `connect` refuses a signal it does not declare, `disconnect` throws for an id that is not
+     * connected. Each of the four installs the real ones on the instance and repeats itself there
+     * (`installElementApi`), so a bare `document.createElement()` answers like a template's child
+     * and an element nobody connects to pays nothing.
+     */
+    connect(signal: string, handler: (emitter: this, ...args: any[]) => unknown): number;
+    disconnect(id: number): void;
+    emit(signal: string, ...args: unknown[]): void;
+    notify(name: string): void;
     /** `gtk_widget_get_mapped`: on screen, which is in the document and rendered. */
     get_mapped(): boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-web",
-    "version": "0.64.11",
+    "version": "0.64.12-next.280",
     "description": "Adwaita/Libadwaita web components for browser targets",
     "type": "module",
     "main": "./src/index.ts",
@@ -58,14 +58,14 @@
         "@codemirror/language": "^6.12.4",
         "@codemirror/state": "^6.7.0",
         "@codemirror/view": "^6.43.4",
-        "@gjsify/adwaita-core": "^0.64.11",
-        "@gjsify/adwaita-fonts": "^0.64.11",
-        "@gjsify/adwaita-icons": "^0.64.11",
-        "@gjsify/gtksource-core": "^0.64.11",
+        "@gjsify/adwaita-core": "0.64.12-next.280",
+        "@gjsify/adwaita-fonts": "0.64.12-next.280",
+        "@gjsify/adwaita-icons": "0.64.12-next.280",
+        "@gjsify/gtksource-core": "0.64.12-next.280",
         "@lezer/highlight": "^1.2.3"
     },
     "peerDependencies": {
-        "@gjsify/app-settings": "^0.64.11"
+        "@gjsify/app-settings": "0.64.12-next.280"
     },
     "peerDependenciesMeta": {
         "@gjsify/app-settings": {
@@ -73,11 +73,11 @@
         }
     },
     "devDependencies": {
-        "@gjsify/app-settings": "^0.64.11",
-        "@gjsify/blueprint": "^0.64.11",
-        "@gjsify/cli": "^0.64.11",
-        "@gjsify/unit": "^0.64.11",
-        "@gjsify/vite-plugin-blueprint": "^0.64.11",
+        "@gjsify/app-settings": "0.64.12-next.280",
+        "@gjsify/blueprint": "0.64.12-next.280",
+        "@gjsify/cli": "0.64.12-next.280",
+        "@gjsify/unit": "0.64.12-next.280",
+        "@gjsify/vite-plugin-blueprint": "0.64.12-next.280",
         "sass": "^1.101.0",
         "typescript": "^6.0.3"
     },
@@ -114,5 +114,6 @@
     "bugs": {
         "url": "https://github.com/gjsify/gjsify/issues"
     },
-    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/web/adwaita-web#readme"
+    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/web/adwaita-web#readme",
+    "gitHead": "0a9185d91127072fce6aa54dc126e87e6ecd0c3d"
 }

package/src/adw-view-switcher-bar.spec.ts

@@ -53,6 +53,18 @@ export const AdwViewSwitcherBarTest = async () => {
             host.remove();
         });
 
+        await it('set_stack / get_stack are the GIR spelling of setStack', () => {
+            const { bar, host } = mountBar(2);
+            const stack = bar.get_stack();
+            expect(stack).not.toBeNull();
+            bar.set_stack(null);
+            expect(bar.get_stack()).toBeNull();
+            expect(bar.stack).toBeNull();
+            bar.set_stack(stack);
+            expect(bar.stack).toBe(stack);
+            host.remove();
+        });
+
         await it('still accepts the legacy `revealed` attribute as the request', () => {
             const { bar, host } = mountBar(2);
             bar.setAttribute('revealed', '');

package/src/elements/adw-alert-dialog.ts

@@ -125,14 +125,6 @@ export class AdwAlertDialog extends WidgetElement {
         ),
     };
 
-    /** `GObject.Object.connect`: installed per instance by `installElementApi`; refuses an undeclared signal. */
-    declare connect: (signal: string, handler: (emitter: this, ...args: any[]) => unknown) => number;
-    /** `GObject.Object.disconnect`: throws for an id that is not connected. */
-    declare disconnect: (id: number) => void;
-    /** `GObject.Object.emit`. */
-    declare emit: (signal: string, ...args: unknown[]) => void;
-    /** `GObject.Object.notify`. */
-    declare notify: (name: string) => void;
     /** `GObject.Object.get_property`, by GTK's dashed name. */
     declare get_property: (name: string) => unknown;
     /** `GObject.Object.set_property`. */

package/src/elements/adw-overlay-split-view.ts

@@ -143,6 +143,23 @@ export class AdwOverlaySplitView extends WidgetElement {
         this.setAttribute('show-sidebar', v ? '' : 'false');
     }
 
+    /** `Adw.OverlaySplitView:show-sidebar` — the GIR spelling of {@link showSidebar}. */
+    get show_sidebar(): boolean {
+        return this.showSidebar;
+    }
+
+    set show_sidebar(v: boolean) {
+        this.showSidebar = v;
+    }
+
+    get_show_sidebar(): boolean {
+        return this.showSidebar;
+    }
+
+    set_show_sidebar(v: boolean): void {
+        this.showSidebar = v;
+    }
+
     get collapsed(): boolean {
         return this._state.collapsed;
     }

package/src/elements/adw-view-stack.ts

@@ -213,6 +213,56 @@ export class AdwViewStack extends WidgetElement {
         return this.add(content, name, title);
     }
 
+    /** `adw_view_stack_add_titled`. */
+    add_titled(child: HTMLElement, name: string, title: string): AdwViewStackPageInfo {
+        return this.add(child, name, title);
+    }
+
+    /** `adw_view_stack_add_named`. */
+    add_named(child: HTMLElement, name: string | null): AdwViewStackPageInfo {
+        return this.add(child, name ?? '');
+    }
+
+    /** `adw_view_stack_add_titled_with_icon`: the same four values as {@link add}, in the same order. */
+    add_titled_with_icon(child: HTMLElement, name: string, title: string, iconName: string): AdwViewStackPageInfo {
+        return this.add(child, name, title, iconName);
+    }
+
+    /**
+     * `adw_view_stack_remove` takes the CHILD. With no argument this is still
+     * `ChildNode.remove()` — the element leaves its parent — because the GIR name and the
+     * DOM name share one spelling here.
+     */
+    override remove(child?: HTMLElement): void {
+        if (child === undefined) {
+            super.remove();
+            return;
+        }
+        const page = this._state.pages.find((held) => held.content === child);
+        if (page) this.removePage(page.name);
+    }
+
+    /** `adw_view_stack_get_visible_child_name`. */
+    get_visible_child_name(): string | null {
+        return this._state.visibleIndex < 0 ? null : this._state.visibleName;
+    }
+
+    /** `adw_view_stack_set_visible_child_name`. */
+    set_visible_child_name(name: string): void {
+        this._state.setVisibleName(name);
+    }
+
+    /** `adw_view_stack_get_visible_child`. */
+    get_visible_child(): HTMLElement | null {
+        return this.visibleChild;
+    }
+
+    /** `adw_view_stack_set_visible_child`; a child that is not a page of this stack selects nothing. */
+    set_visible_child(child: HTMLElement): void {
+        const at = this._state.pages.findIndex((page) => page.content === child);
+        if (at !== -1) this._state.setVisibleIndex(at);
+    }
+
     /**
      * Remove the first page named `name` and detach its content. Returns whether
      * anything was removed. When the removed page was the visible one the stack

package/src/elements/adw-view-switcher-bar.ts

@@ -139,6 +139,16 @@ export class AdwViewSwitcherBar extends WidgetElement {
         }
     }
 
+    /** `adw_view_switcher_bar_set_stack` — the GIR spelling of {@link setStack}. */
+    set_stack(stack: AdwViewStack | null): void {
+        this.setStack(stack);
+    }
+
+    /** `adw_view_switcher_bar_get_stack`. */
+    get_stack(): AdwViewStack | null {
+        return this._stack;
+    }
+
     /** Bind to a stack element (or null). Unbinds the previous one and rebuilds. */
     setStack(stack: AdwViewStack | null): void {
         this._unbindStack();

package/src/elements/gtk-box.ts

@@ -31,7 +31,12 @@
 // Reference: refs/gtk/gtk/gtkbox.c (the three properties, the `box` CSS name)
 // Copyright (c) The GTK Team. LGPLv2.1+.
 
-import { normalizeBoxOrientation, normalizeBoxSpacing, type BoxOrientation } from '@gjsify/adwaita-core';
+import {
+    normalizeBoxOrientation,
+    normalizeBoxSpacing,
+    resolveWrapBoxChildOrder,
+    type BoxOrientation,
+} from '@gjsify/adwaita-core';
 import { WidgetElement } from '../widget-element.js';
 
 import { computeExpand, explicitExpand, type ExpandOrientation } from '../compute-expand.js';
@@ -79,6 +84,49 @@ export class GtkBox extends WidgetElement {
         this.toggleAttribute('homogeneous', !!value);
     }
 
+    // `gtk_box_append` and `gtk_box_prepend` are deliberately NOT redeclared:
+    // `ParentNode.append` / `.prepend` ARE those two, with the same semantics.
+
+    /**
+     * `gtk_box_remove` under its GIR name. With no argument it stays `ChildNode.remove()`:
+     * the box leaves its own parent. A `child` that is not a direct child is where C warns
+     * (`g_warning ("Trying to remove a widget that is not a child")`) and does nothing.
+     */
+    override remove(child?: Element): void {
+        if (child === undefined) {
+            super.remove();
+            return;
+        }
+        if (child.parentNode !== this) {
+            console.warn('Gtk.Box: trying to remove a widget that is not a child of this box');
+            return;
+        }
+        this.removeChild(child);
+    }
+
+    /**
+     * `gtk_box_insert_child_after`. A NULL/absent `sibling` inserts at the FIRST position,
+     * not the last — `gtk_widget_insert_after`'s rule, pinned by
+     * `WRAP_BOX_CHILD_ORDER_VECTORS`. Returns whether the insert happened; a refusal is where
+     * C would have hit a `g_return_if_fail`.
+     */
+    insert_child_after(child: Element, sibling: Element | null = null): boolean {
+        return this._applyOrder('insert-after', child, sibling);
+    }
+
+    /** `gtk_box_reorder_child_after`. Same NULL rule. */
+    reorder_child_after(child: Element, sibling: Element | null = null): boolean {
+        return this._applyOrder('reorder-after', child, sibling);
+    }
+
+    private _applyOrder(op: 'insert-after' | 'reorder-after', child: Element, sibling: Element | null): boolean {
+        const next = resolveWrapBoxChildOrder({ children: [...this.children], child, sibling, op });
+        if (next === null) return false;
+        // Move exactly the one node, so no sibling is detached and loses focus.
+        this.insertBefore(child, next[next.indexOf(child) + 1] ?? null);
+        return true;
+    }
+
     connectedCallback() {
         this._sync();
         this._syncComputedExpand();

package/src/elements/gtk-menu-button.ts

@@ -99,6 +99,23 @@ export class GtkMenuButton extends WidgetElement {
         if (this._initialized) this._renderMenu();
     }
 
+    /** `Gtk.MenuButton:menu-model` — the GIR spelling of {@link menuModel}. */
+    get menu_model(): AdwMenuModel {
+        return this.menuModel;
+    }
+
+    set menu_model(value: AdwMenuInput) {
+        this.menuModel = value;
+    }
+
+    get_menu_model(): AdwMenuModel {
+        return this.menuModel;
+    }
+
+    set_menu_model(value: AdwMenuInput): void {
+        this.menuModel = value;
+    }
+
     /**
      * Normalise, REFUSE, store — the one door every menu comes through.
      *