@gjsify/adwaita-web 0.53.0 → 0.55.0

package/lib/types/gtk-expander.spec.d.ts

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

package/lib/types/gtk-fixed.spec.d.ts

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

package/lib/types/gtk-flow-box.spec.d.ts

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

package/lib/types/gtk-font-dialog-button.spec.d.ts

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

package/lib/types/gtk-frame.spec.d.ts

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

package/lib/types/gtk-gl-area.spec.d.ts

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

package/lib/types/gtk-graphics-offload.spec.d.ts

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

package/lib/types/gtk-grid-view.spec.d.ts

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

package/lib/types/gtk-grid.spec.d.ts

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

package/lib/types/gtk-header-bar.spec.d.ts

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

package/lib/types/gtk-inscription.spec.d.ts

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

package/lib/types/gtk-level-bar.spec.d.ts

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

package/lib/types/gtk-link-button.spec.d.ts

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

package/lib/types/gtk-list-box.spec.d.ts

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

package/lib/types/gtk-list-view.spec.d.ts

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

package/lib/types/gtk-media-controls.spec.d.ts

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

package/lib/types/gtk-notebook.spec.d.ts

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

package/lib/types/gtk-overlay.spec.d.ts

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

package/lib/types/gtk-paned.spec.d.ts

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

package/lib/types/gtk-password-entry.spec.d.ts

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

package/lib/types/gtk-picture.spec.d.ts

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

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

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

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

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

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

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

package/lib/types/gtk-popover-role.spec.d.ts

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

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

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

package/lib/types/gtk-print-dialogs.spec.d.ts

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

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

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

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

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

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

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

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

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

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

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

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

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

package/lib/types/gtk-search-entry.spec.d.ts

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/lib/types/gtk-toggle-button.spec.d.ts

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

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

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

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

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

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

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

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

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

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

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

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

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

package/lib/types/index.d.ts

@@ -6,7 +6,8 @@ export type { AdwAccentSource } from './appearance.js';
 export { AdwScrollShading } from './scroll-shading.js';
 export type { AdwUndershootEdges } from './scroll-shading.js';
 export { buildSharedTree, mountSharedTree } from './shared-tree-builder.js';
-export type { MountedSharedTree } from './shared-tree-builder.js';
+export type { MountedSharedTree, SizeSource } from './shared-tree-builder.js';
+export { registerTemplateClass } from './template-classes.js';
 export { isIconAvailable, registerIcon } from './icon-registry.js';
 export * as Adw from './namespace/adw.js';
 export * as Gtk from './namespace/gtk.js';
@@ -20,6 +21,8 @@ export { AdwTabPage } from './elements/adw-tab-view.js';
 export { AdwViewSwitcherPage } from './elements/adw-view-switcher.js';
 export { AdwViewStackPage } from './elements/adw-inline-view-switcher.js';
 export { AdwSidebarItem, AdwSidebarSection } from './elements/adw-sidebar.js';
+export { AdwShortcutsSection } from './elements/adw-shortcuts-section.js';
+export { AdwShortcutsItem } from './elements/adw-shortcuts-item.js';
 export { AdwBottomSheetBottomBar, AdwBottomSheetContent, AdwBottomSheetSheet } from './elements/adw-bottom-sheet.js';
 export { AdwAlertResponse } from './elements/adw-alert-dialog.js';
 export type { GtkPopoverAlign, GtkPopoverPosition, GtkPopoverRole } from './elements/gtk-popover.js';

package/lib/types/list-view-dom.d.ts

@@ -0,0 +1,44 @@
+import type { AdwListItemFactory } from '@gjsify/adwaita-core';
+/** The class every row/cell label carries, so one stylesheet rule reaches all three views. */
+export declare const LIST_ITEM_LABEL_CLASS = "adw-list-item-label";
+/**
+ * What a view draws for an item when no `factory` was set.
+ *
+ * GTK HAS NO DEFAULT FACTORY — `gtk_list_view_new (model, NULL)` is legal and draws empty
+ * rows, which on a documentation surface is indistinguishable from a broken widget. So
+ * the port's default is the factory every upstream example writes by hand: a label bound
+ * to the item. Setting `factory` replaces it, and that is the only way to get GTK's own
+ * answer back.
+ */
+export declare const defaultListItemFactory: AdwListItemFactory<Node>;
+/** What {@link attachRubberBand} needs to know about the view it bands. */
+export interface AdwRubberBandInit {
+    /** The element the pointer listeners sit on. */
+    host: HTMLElement;
+    /** The positioned box the band is drawn inside — the row container. */
+    surface: HTMLElement;
+    /** Whether a drag may start right now: `enable-rubberband` AND a multiple selection. */
+    enabled: () => boolean;
+    /** The row elements, in model order. */
+    rows: () => readonly HTMLElement[];
+    /** Select every position the band covers, replacing the selection. */
+    selectPositions: (positions: readonly number[]) => void;
+}
+/**
+ * Rubberband selection — drag on the view's background to select what the rectangle
+ * covers.
+ *
+ * GTK runs this as a drag gesture on `GtkListBase` and draws a `rubberband` CSS node,
+ * which libadwaita styles as an accent border over a 20% accent fill
+ * (`_views.scss:47-50`); this builds the same node and lets that rule reach it.
+ *
+ * THE DRAG MUST START ON THE BACKGROUND. A press that lands on a row is that row's click
+ * — GTK's row gesture claims the sequence — so starting a band there would make every
+ * click a one-pixel drag and swallow the row's own selection step.
+ *
+ * The hit test is `getBoundingClientRect` per row against the band, which is the same
+ * question GTK answers against its tile areas. It is recomputed per pointermove rather
+ * than cached: a row's box can change mid-drag (a scroll, a factory that lays out late),
+ * and a cached rectangle would select the wrong rows without anything looking wrong.
+ */
+export declare function attachRubberBand(init: AdwRubberBandInit): void;

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/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,6 +15,30 @@ 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
@@ -60,5 +85,8 @@ export interface MountedSharedTree {
  * 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?: {
+    scope?: Readonly<Record<string, unknown>>;
+    observeSize?: SizeSource;
+}): MountedSharedTree;
 export {};

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;