@gjsify/adwaita-web 0.54.0 → 0.56.0

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

@@ -1,21 +1,27 @@
 export { AdwAboutDialog as AboutDialog } from '../elements/adw-about-dialog.js';
 export { AdwActionRow as ActionRow } from '../elements/adw-action-row.js';
 export { AdwAlertDialog as AlertDialog } from '../elements/adw-alert-dialog.js';
+export { AdwApplicationWindow as ApplicationWindow } from '../elements/adw-application-window.js';
 export { AdwAvatar as Avatar } from '../elements/adw-avatar.js';
 export { AdwBanner as Banner } from '../elements/adw-banner.js';
+export { AdwBin as Bin } from '../elements/adw-bin.js';
 export { AdwBottomSheet as BottomSheet } from '../elements/adw-bottom-sheet.js';
+export { AdwBreakpointBin as BreakpointBin } from '../elements/adw-breakpoint-bin.js';
 export { AdwButtonContent as ButtonContent } from '../elements/adw-button-content.js';
 export { AdwButtonRow as ButtonRow } from '../elements/adw-button-row.js';
 export { AdwCarousel as Carousel } from '../elements/adw-carousel.js';
 export { AdwCarouselIndicatorDots as CarouselIndicatorDots } from '../elements/adw-carousel.js';
 export { AdwCarouselIndicatorLines as CarouselIndicatorLines } from '../elements/adw-carousel.js';
 export { AdwClamp as Clamp } from '../elements/adw-clamp.js';
+export { AdwClampScrollable as ClampScrollable } from '../elements/adw-clamp-scrollable.js';
 export { AdwComboRow as ComboRow } from '../elements/adw-combo-row.js';
 export { AdwDialog as Dialog } from '../elements/adw-dialog.js';
 export { AdwEntryRow as EntryRow } from '../elements/adw-entry-row.js';
 export { AdwExpanderRow as ExpanderRow } from '../elements/adw-expander-row.js';
 export { AdwHeaderBar as HeaderBar } from '../elements/adw-header-bar.js';
 export { AdwInlineViewSwitcher as InlineViewSwitcher } from '../elements/adw-inline-view-switcher.js';
+export { AdwLayoutSlot as LayoutSlot } from '../elements/adw-layout-slot.js';
+export { AdwMultiLayoutView as MultiLayoutView } from '../elements/adw-multi-layout-view.js';
 export { AdwNavigationPage as NavigationPage } from '../elements/adw-navigation-view.js';
 export { AdwNavigationSplitView as NavigationSplitView } from '../elements/adw-navigation-split-view.js';
 export { AdwNavigationView as NavigationView } from '../elements/adw-navigation-view.js';
@@ -24,13 +30,18 @@ export { AdwPasswordEntryRow as PasswordEntryRow } from '../elements/adw-passwor
 export { AdwPreferencesDialog as PreferencesDialog } from '../elements/adw-preferences-dialog.js';
 export { AdwPreferencesGroup as PreferencesGroup } from '../elements/adw-preferences-group.js';
 export { AdwPreferencesPage as PreferencesPage } from '../elements/adw-preferences-dialog.js';
+export { AdwPreferencesRow as PreferencesRow } from '../elements/adw-preferences-row.js';
 export { AdwShortcutLabel as ShortcutLabel } from '../elements/adw-shortcut-label.js';
+export { AdwShortcutsDialog as ShortcutsDialog } from '../elements/adw-shortcuts-dialog.js';
 export { AdwSidebar as Sidebar } from '../elements/adw-sidebar.js';
 export { AdwSpinRow as SpinRow } from '../elements/adw-spin-row.js';
 export { AdwSpinner as Spinner } from '../elements/adw-spinner.js';
 export { AdwSplitButton as SplitButton } from '../elements/adw-split-button.js';
 export { AdwStatusPage as StatusPage } from '../elements/adw-status-page.js';
 export { AdwSwitchRow as SwitchRow } from '../elements/adw-switch-row.js';
+export { AdwTabBar as TabBar } from '../elements/adw-tab-bar.js';
+export { AdwTabButton as TabButton } from '../elements/adw-tab-button.js';
+export { AdwTabOverview as TabOverview } from '../elements/adw-tab-overview.js';
 export { AdwTabView as TabView } from '../elements/adw-tab-view.js';
 export { AdwToastOverlay as ToastOverlay } from '../elements/adw-toast-overlay.js';
 export { AdwToggle as Toggle } from '../elements/adw-toggle-group.js';
@@ -38,6 +49,7 @@ export { AdwToggleGroup as ToggleGroup } from '../elements/adw-toggle-group.js';
 export { AdwToolbarView as ToolbarView } from '../elements/adw-toolbar-view.js';
 export { AdwViewStack as ViewStack } from '../elements/adw-view-stack.js';
 export { AdwViewSwitcher as ViewSwitcher } from '../elements/adw-view-switcher.js';
+export { AdwViewSwitcherSidebar as ViewSwitcherSidebar } from '../elements/adw-view-switcher-sidebar.js';
 export { AdwViewSwitcherBar as ViewSwitcherBar } from '../elements/adw-view-switcher-bar.js';
 export { AdwWindow as Window } from '../elements/adw-window.js';
 export { AdwWindowTitle as WindowTitle } from '../elements/adw-window-title.js';

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

@@ -1,14 +1,75 @@
 export { GtkAdjustment as Adjustment } from '@gjsify/adwaita-core';
+export { GtkAboutDialog as AboutDialog } from '../elements/gtk-about-dialog.js';
 export { GtkActionBar as ActionBar } from '../elements/gtk-action-bar.js';
+export { GtkApplicationWindow as ApplicationWindow } from '../elements/gtk-application-window.js';
+export { GtkAspectFrame as AspectFrame } from '../elements/gtk-aspect-frame.js';
 export { GtkBox as Box } from '../elements/gtk-box.js';
 export { GtkButton as Button } from '../elements/gtk-button.js';
+export { GtkCalendar as Calendar } from '../elements/gtk-calendar.js';
+export { GtkCenterBox as CenterBox } from '../elements/gtk-center-box.js';
 export { GtkCheckButton as CheckButton } from '../elements/checks.js';
+export { GtkColorDialogButton as ColorDialogButton } from '../elements/gtk-color-dialog-button.js';
+export { GtkColumnView as ColumnView } from '../elements/gtk-column-view.js';
 export { GtkDropDown as DropDown } from '../elements/gtk-drop-down.js';
+export { GtkDrawingArea as DrawingArea } from '../elements/gtk-drawing-area.js';
+export { GtkDragIcon as DragIcon } from '../elements/gtk-drag-icon.js';
+export { GtkEditableLabel as EditableLabel } from '../elements/gtk-editable-label.js';
+export { GtkEmojiChooser as EmojiChooser } from '../elements/gtk-emoji-chooser.js';
 export { GtkEntry as Entry } from '../elements/gtk-entry.js';
+export { GtkExpander as Expander } from '../elements/gtk-expander.js';
+export { GtkFixed as Fixed } from '../elements/gtk-fixed.js';
+export { GtkFlowBox as FlowBox } from '../elements/gtk-flow-box.js';
+export { GtkFlowBoxChild as FlowBoxChild } from '../elements/gtk-flow-box-child.js';
+export { GtkFontDialogButton as FontDialogButton } from '../elements/gtk-font-dialog-button.js';
+export { GtkFrame as Frame } from '../elements/gtk-frame.js';
+export { GtkGLArea as GLArea } from '../elements/gtk-gl-area.js';
+export { GtkGraphicsOffload as GraphicsOffload } from '../elements/gtk-graphics-offload.js';
+export { GtkGrid as Grid } from '../elements/gtk-grid.js';
+export { GtkGridView as GridView } from '../elements/gtk-grid-view.js';
+export { GtkHeaderBar as HeaderBar } from '../elements/gtk-header-bar.js';
 export { GtkImage as Image } from '../elements/gtk-image.js';
+export { GtkLinkButton as LinkButton } from '../elements/gtk-link-button.js';
 export { GtkLabel as Label } from '../elements/gtk-label.js';
+export { GtkInscription as Inscription } from '../elements/gtk-inscription.js';
+export { GtkLevelBar as LevelBar } from '../elements/gtk-level-bar.js';
+export { GtkListBox as ListBox } from '../elements/gtk-list-box.js';
+export { GtkListBoxRow as ListBoxRow } from '../elements/gtk-list-box-row.js';
+export { GtkListView as ListView } from '../elements/gtk-list-view.js';
+export { GtkMediaControls as MediaControls } from '../elements/gtk-media-controls.js';
 export { GtkMenuButton as MenuButton } from '../elements/gtk-menu-button.js';
+export { GtkNotebook as Notebook } from '../elements/gtk-notebook.js';
+export { GtkOverlay as Overlay } from '../elements/gtk-overlay.js';
+export { GtkPageSetupUnixDialog as PageSetupUnixDialog } from '../elements/gtk-page-setup-unix-dialog.js';
+export { GtkPaned as Paned } from '../elements/gtk-paned.js';
+export { GtkPasswordEntry as PasswordEntry } from '../elements/gtk-password-entry.js';
+export { GtkPicture as Picture } from '../elements/gtk-picture.js';
 export { GtkPopover as Popover } from '../elements/gtk-popover.js';
+export { GtkPopoverBin as PopoverBin } from '../elements/gtk-popover-bin.js';
+export { GtkPopoverMenu as PopoverMenu } from '../elements/gtk-popover-menu.js';
+export { GtkPopoverMenuBar as PopoverMenuBar } from '../elements/gtk-popover-menu-bar.js';
+export { GtkPrintUnixDialog as PrintUnixDialog } from '../elements/gtk-print-unix-dialog.js';
 export { GtkProgressBar as ProgressBar } from '../elements/gtk-progress-bar.js';
+export { GtkRevealer as Revealer } from '../elements/gtk-revealer.js';
+export { GtkScale as Scale } from '../elements/gtk-scale.js';
+export { GtkScaleButton as ScaleButton } from '../elements/gtk-scale-button.js';
+export { GtkSearchBar as SearchBar } from '../elements/gtk-search-bar.js';
+export { GtkSearchEntry as SearchEntry } from '../elements/gtk-search-entry.js';
+export { GtkScrolledWindow as ScrolledWindow } from '../elements/gtk-scrolled-window.js';
+export { GtkScrollbar as Scrollbar } from '../elements/gtk-scrollbar.js';
+export { GtkSeparator as Separator } from '../elements/gtk-separator.js';
+export { GtkSpinButton as SpinButton } from '../elements/gtk-spin-button.js';
+export { GtkSpinner as Spinner } from '../elements/gtk-spinner.js';
+export { GtkStack as Stack } from '../elements/gtk-stack.js';
+export { GtkStackSidebar as StackSidebar } from '../elements/gtk-stack-sidebar.js';
+export { GtkStackSwitcher as StackSwitcher } from '../elements/gtk-stack-switcher.js';
 export { GtkStringList as StringList } from '@gjsify/adwaita-core';
 export { GtkSwitch as Switch } from '../elements/gtk-switch.js';
+export { GtkText as Text } from '../elements/gtk-text.js';
+export { GtkTextView as TextView } from '../elements/gtk-text-view.js';
+export { GtkToggleButton as ToggleButton } from '../elements/gtk-toggle-button.js';
+export { GtkTreeExpander as TreeExpander } from '../elements/gtk-tree-expander.js';
+export { GtkVideo as Video } from '../elements/gtk-video.js';
+export { GtkWindow as Window } from '../elements/gtk-window.js';
+export { GtkWindowControls as WindowControls } from '../elements/gtk-window-controls.js';
+export { GtkViewport as Viewport } from '../elements/gtk-viewport.js';
+export { GtkWindowHandle as WindowHandle } from '../elements/gtk-window-handle.js';

package/lib/types/page-setup.d.ts

@@ -0,0 +1,100 @@
+/** `Gtk.PageOrientation`, in enum order. Reversed orientations are separate values. */
+export declare const PAGE_ORIENTATIONS: readonly ["portrait", "landscape", "reverse-portrait", "reverse-landscape"];
+/** One `Gtk.PageOrientation` — the nicks `packages/framework/gtk-host` generates. */
+export type PageOrientation = (typeof PAGE_ORIENTATIONS)[number];
+/** The `Gtk.Unit` the two dialogs' labels speak: millimetres or inches. */
+export type PageUnit = 'mm' | 'inch';
+/** One row of GTK's `paper_names` table, in millimetres. */
+export interface PaperSize {
+    /** The `GtkPaperSize` name — `iso_a4`, `na_letter`, … */
+    readonly name: string;
+    /** `gtk_paper_size_get_display_name()` — `A4`, `US Letter`, … */
+    readonly displayName: string;
+    /** Short edge, mm. */
+    readonly width: number;
+    /** Long edge, mm. */
+    readonly height: number;
+}
+/**
+ * The twelve `common_paper_sizes`, in the order `fill_paper_sizes_from_printer` appends
+ * them when there is no printer (gtkpagesetupunixdialog.c:474-491): the list is
+ * deliberately NOT sorted, so the order here is the one a reader sees.
+ *
+ * Sizes and names are the `paper_names.c` rows for those keys; `in` sizes are
+ * converted once, at parse time, exactly as `parse_media_size` does.
+ */
+export declare const COMMON_PAPER_SIZES: readonly PaperSize[];
+/**
+ * `double_to_string` (gtkpagesetupunixdialog.c:594-628).
+ *
+ * The comment above the C is the reason this is not `toFixed`: the author wanted no
+ * decimal point at all on a whole number and at most one significant digit otherwise,
+ * and `printf` offers no "max precision" — so the code prints two places in inch and
+ * one in mm and then strips the zeros and the separator by hand. The stripping is
+ * ASCII-only and drops a `0.0` to `0`.
+ */
+export declare function doubleToString(value: number, unit: PageUnit): string;
+/** The four margins of a `Gtk.PageSetup`, in millimetres. */
+export interface PageMargins {
+    readonly top: number;
+    readonly bottom: number;
+    readonly left: number;
+    readonly right: number;
+}
+/**
+ * `gtk_page_setup_set_paper_size_and_default_margins` (gtkpagesetup.c:248-258) —
+ * every margin `gtk_paper_size_get_default_*_margin` returns, for one paper size.
+ */
+export declare function defaultMargins(size: PaperSize): PageMargins;
+/** A plain-data `Gtk.PageSetup`: which paper, which way up, and the four margins. */
+export interface PageSetup {
+    /** The `GtkPaperSize` name. */
+    readonly paperSize: string;
+    /** `GtkPageOrientation`. */
+    readonly orientation: PageOrientation;
+    /** Margins in millimetres, which is what `GtkPageSetup` stores internally. */
+    readonly margins: PageMargins;
+}
+/**
+ * `gtk_page_setup_new()` — the default setup GTK hands a dialog that has been given
+ * none: ISO A4, portrait, the default margins for it.
+ */
+export declare function defaultPageSetup(): PageSetup;
+/**
+ * `gtk_paper_size_new (name)` + the margins, for one of the twelve common sizes, or
+ * `null` for a name the table does not have — which is what `set_paper_size` sees
+ * when no row matches (it returns FALSE rather than inventing one).
+ */
+export declare function paperSizeByName(name: string): PaperSize | null;
+/** The paper size a setup names, or the default one when the name is unknown. */
+export declare function paperSizeOf(setup: PageSetup): PaperSize;
+/**
+ * `page_setup_is_equal` (gtkpagesetupunixdialog.c:410-418): same paper AND the same
+ * four margins. `page_setup_is_same_size` is the first half of it, which
+ * `set_paper_size` asks for when a new printer brings its own sizes along.
+ */
+export declare function pageSetupEquals(a: PageSetup, b: PageSetup): boolean;
+/** `page_setup_is_same_size` — the paper alone, margins ignored. */
+export declare function pageSetupSameSize(a: PageSetup, b: PageSetup): boolean;
+/**
+ * The width and height a `GtkPageSetup` reports for an orientation: landscape and
+ * reverse-landscape SWAP the two edges, which is the whole of
+ * `gtk_page_setup_get_orientation`-aware geometry in GTK (there is no separate
+ * landscape size).
+ */
+export declare function orientedSize(setup: PageSetup, unit?: PageUnit): {
+    width: number;
+    height: number;
+};
+/** The `unit_str` of `paper_size_changed`: `_("mm")` or `_("inch")`. */
+export declare function unitLabel(unit: PageUnit): string;
+/**
+ * The label under the paper-size combo: `W × H unit`, both numbers through
+ * {@link doubleToString} and in the dialog's user unit.
+ */
+export declare function paperSizeLabel(setup: PageSetup, unit?: PageUnit): string;
+/**
+ * The tooltip `paper_size_changed` puts on the same label — the margins alone, in its
+ * order: left, right, top, bottom. The sizes live in the label text, not here.
+ */
+export declare function paperMarginsTooltip(setup: PageSetup, unit?: PageUnit): string;

package/lib/types/row-line-clamp.d.ts

@@ -0,0 +1,20 @@
+export interface RowLineClampConfig {
+    titleEl: HTMLElement;
+    subtitleEl: HTMLElement;
+    textContainerEl: HTMLElement;
+    getTitleLines: () => number;
+    getSubtitleLines: () => number;
+}
+/**
+ * Apply or remove line clamping based on title-lines/subtitle-lines values.
+ * Uses CSS custom properties and class toggle (not inline styles).
+ */
+export declare function applyRowLineClamp(config: RowLineClampConfig): void;
+/**
+ * Parse a lines attribute value following AdwActionRow semantics:
+ * - Missing/null/empty → 0 (unlimited)
+ * - Invalid/non-numeric → 0 (unlimited)
+ * - n > 0 → n (clamp to n lines)
+ * - n <= 0 → 0 (unlimited; pspec range is 0..G_MAXINT)
+ */
+export declare function parseRowLinesAttribute(value: string | null): number;

package/lib/types/row-tooltip.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Apply `row`'s `tooltip-text` to `parts`, or clear it when the attribute is absent.
+ *
+ * `parts` are the row's OWN sections, never a slotted consumer widget — see the header.
+ * Each one is marked `data-row-tooltip`, which is the hook `scss/_row.scss` stretches so
+ * the tooltip covers the row rather than the label text inside it.
+ */
+export declare function applyRowTooltip(row: HTMLElement, parts: readonly Element[]): void;

package/lib/types/row-tooltip.spec.d.ts

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

package/lib/types/scroll-shading.d.ts

@@ -5,6 +5,19 @@ export interface AdwUndershootEdges {
     /** `undershoot-bottom` on the view. */
     bottom: boolean;
 }
+/**
+ * What a caller can ask to hear about, which is `GtkScrolledWindow::edge-overshot`'s own
+ * argument: the SIGNED distance past the edge, negative at the near one and positive at the
+ * far one, and `0` when the position is back inside the range.
+ *
+ * The alternative is a second copy of the overshoot accumulation in the caller, which is
+ * the duplication this module exists to prevent — the unclamped position is a value only
+ * the wheel bookkeeping here has.
+ */
+export interface AdwScrollShadingOptions {
+    /** Called whenever a wheel pushes a scroller's position past one of its edges. */
+    onOvershoot?: (distance: number) => void;
+}
 /**
  * Keeps every scroller under a root marked with its live edge indicators.
  *
@@ -24,7 +37,8 @@ export declare class AdwScrollShading {
     private _shaded;
     private _pendingScan;
     private _undershootEdges;
-    constructor(root: HTMLElement);
+    private _onOvershoot;
+    constructor(root: HTMLElement, options?: AdwScrollShadingOptions);
     /**
      * Which edges may draw an UNDERSHOOT. The overshoot glow is not gated: upstream
      * draws it on every `scrolledwindow`, while the undershoot is what a toolbar

package/lib/types/shared-tree-builder.d.ts

@@ -1,4 +1,5 @@
-import type { SharedTreeNode } from '@gjsify/adwaita-core/conformance';
+import { type BreakpointSize } from '@gjsify/adwaita-core';
+import { type SharedTreeNode } from '@gjsify/adwaita-core/conformance';
 /** One authored placement, kept so {@link mountSharedTree} can hold the renderer to it. */
 interface PlacedChild {
     parent: HTMLElement;
@@ -14,26 +15,51 @@ interface ExtendedNode {
 interface BuildRecord {
     placed: PlacedChild[];
     extended: ExtendedNode[];
+    /** Every authored id and the element it built, which a `bind` source is looked up in. */
+    ids: Map<string, HTMLElement>;
+    /** The `bindings` of every node, resolved once every id exists (a source may be built after its target). */
+    binds: PendingBind[];
+    /** The nodes that carry `breakpoints`, wired once every id exists (a setter may name a later sibling). */
+    breakpointHosts: {
+        el: HTMLElement;
+        node: SharedTreeNode;
+    }[];
+    /** Undoes what the build wired to the outside (the size observers); {@link mountSharedTree}'s `unmount` runs it. */
+    disposers: (() => void)[];
+    /** The size source a `breakpoints` node is driven from; a `ResizeObserver` unless the caller supplies one. */
+    observeSize?: SizeSource;
+    /** The object a signal handler's NAME is resolved against (ADR 0093 § 3), as `Gtk.BuilderScope` does. */
+    scope?: Readonly<Record<string, unknown>>;
+}
+/** Calls `onSize` with the host's measured size, now and on every change; returns its disposer. */
+export type SizeSource = (element: Element, onSize: (size: BreakpointSize) => void) => () => void;
+interface PendingBind {
+    el: HTMLElement;
+    property: string;
+    source: string;
+    sourceProperty: string;
+    flags: readonly string[];
 }
 /**
  * A `SharedTreeNode`, realised as a DETACHED element tree: a tag, its authored properties as
  * attributes, its style classes as classes, its extensions (ADR 0072) as the markup the element
  * reads, its placement as `slot=`, its children, in that order — recursive and total,
- * no tag list, no per-block case. A boolean authored property is the ATTRIBUTE'S PRESENCE
- * (`toggleAttribute`), which is what every element in the corpus reads
- * (`hasAttribute('revealed')`, `hasAttribute('expanded')`); spelling `"true"` would set a
- * present attribute for `false` as well.
+ * no tag list, no per-block case.
+ *
+ * BOOLEAN ATTRIBUTES are written per (widget, property), not per attribute name. The same
+ * attribute name (e.g. `revealed`) can be VALUE-BASED for one widget (`gtk-action-bar`,
+ * default TRUE) and PRESENCE-BASED for another (`adw-banner`, default FALSE). The
+ * per-widget map in `@gjsify/adwaita-core/tags` ({@link isValueBasedBooleanAttr}) records this.
  *
- * EXCEPT AN AUTHORED `false` ON A PROPERTY THE ELEMENT DECLARES. Absence cannot say `false`
- * where the GTK default is TRUE — `AdwNavigationPage:can-pop`, `GtkActionBar:revealed` —
- * because those elements read an absent attribute as that default, so `can-pop: false`
- * reached the page as `can-pop` unset and the page stayed poppable. The element's own
- * property setter knows its attribute convention, so an authored `false` is written
- * through it when the element (already upgraded: `createElement` of a defined tag
- * constructs it) declares one; everything else keeps the presence rule. "Declares" means a
- * member it can WRITE ({@link isWritable}): a getter-only accessor of the same name — the
- * split button's and the menu button's read-only `active` — would throw a bare `TypeError`
- * out of the assignment, so such a property falls back to the presence rule too.
+ * - VALUE-BASED: `attr="false"` means false, absent means true (the GTK default).
+ *   The builder writes `attr="true"|"false"` directly via {@link writeBooleanAttribute}.
+ * - PRESENCE-BASED (style classes like `flat`, `round`, `compact`): `toggleAttribute`
+ *   writes the bare attribute for `true`, removes it for `false`.
+ *
+ * EXCEPT an authored `false` on a NON-value-based, WRITABLE property: the property is set
+ * directly (bypassing the attribute) because the element's setter will reflect it correctly.
+ * A getter-only property of the same name (e.g. `AdwSplitButton.active`) falls back to the
+ * presence rule since assignment would throw.
  *
  * THE SLOT IS WRITTEN AS THE ATTRIBUTE THIS RENDERER ALREADY ROUTES ON, not translated:
  * `src/slotted-children.ts` reads `slot=` off every light-DOM child and keeps the routing
@@ -47,18 +73,50 @@ interface BuildRecord {
  * upgraded has declared no slots yet, so the refusal below belongs to the mount.
  */
 export declare function buildSharedTree(node: SharedTreeNode, record?: BuildRecord): HTMLElement;
+/**
+ * One authored property, written as the element reads it; a breakpoint setter takes the same door.
+ *
+ * BOOLEAN ATTRIBUTES are written per (widget, property), not per attribute name. The same
+ * attribute name (e.g. `revealed`) can be VALUE-BASED for one widget (`gtk-action-bar`,
+ * default TRUE) and PRESENCE-BASED for another (`adw-banner`, default FALSE). The
+ * per-widget map in `@gjsify/adwaita-core/tags` ({@link isValueBasedBooleanAttr}) records this.
+ *
+ * - VALUE-BASED: `attr="false"` means false, absent means true (the GTK default).
+ *   The builder writes `attr="true"|"false"` directly via {@link writeBooleanAttribute}.
+ * - PRESENCE-BASED (style classes like `flat`, `round`, `compact`): `toggleAttribute`
+ *   writes the bare attribute for `true`, removes it for `false`.
+ *
+ * EXCEPT an authored `false` on a NON-value-based, WRITABLE property: the property is set
+ * directly (bypassing the attribute) because the element's setter will reflect it correctly.
+ * A getter-only property of the same name (e.g. `AdwSplitButton.active`) falls back to the
+ * presence rule since assignment would throw. `hexpand` / `vexpand` keep an authored `false`
+ * as the attribute `"false"` and a later `true` rewrites it — `GTK_WIDGET_EXPAND` says why.
+ */
+export declare function writeProp(el: HTMLElement, prop: string, value: string | number | boolean): void;
 /** A tree {@link mountSharedTree} built and connected. */
 export interface MountedSharedTree {
     /** The authored root — connected, so every custom element under it has upgraded and run. */
     root: HTMLElement;
-    /** Disconnects and discards the mount point. */
+    /** Disconnects the tree, and discards the mount point when this call made one. */
     unmount: () => void;
 }
+/** What {@link mountSharedTree} takes beside the tree. */
+export interface MountOptions {
+    /** The object a handler NAME is looked up on (ADR 0093 § 3). */
+    scope?: Readonly<Record<string, unknown>>;
+    /** The size source a `breakpoints` node is driven from. */
+    observeSize?: SizeSource;
+    /**
+     * Where the root is appended — a showcase's own container, which then lays the window out.
+     * Without it the tree gets a fresh host `<div>` in `document.body`, discarded on `unmount`.
+     */
+    into?: HTMLElement;
+}
 /**
  * {@link buildSharedTree}, attached under a fresh host `<div>` in `document.body` so the tree
  * — and every custom element in it — is REAL rather than merely constructed. This is the
  * instantiation half a caller reading the corpus's elements normally wants; a bare
  * `buildSharedTree` is for a caller that already has somewhere of its own to attach it.
  */
-export declare function mountSharedTree(node: SharedTreeNode): MountedSharedTree;
+export declare function mountSharedTree(node: SharedTreeNode, options?: MountOptions): MountedSharedTree;
 export {};

package/lib/types/shared-tree-mount.spec.d.ts

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

package/lib/types/signals.d.ts

@@ -0,0 +1,4 @@
+/** GTK signal name → the DOM event type the element dispatches it as. */
+export type DispatchedSignals = Readonly<Record<string, string>>;
+/** The signals `el`'s class declares, or none. */
+export declare function dispatchedSignalsOf(el: Element): DispatchedSignals;