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

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

@@ -0,0 +1,25 @@
+import { type DispatchedSignals } from './signals.js';
+export declare class WidgetElement extends HTMLElement {
+    /** `Gtk.Widget::map` / `::unmap`, which every subclass inherits (`dispatchedSignalsOf`). */
+    static readonly signals: DispatchedSignals;
+    /** `Gtk.Widget:visible`. */
+    get visible(): boolean;
+    set visible(value: boolean);
+    /** `gtk_widget_get_visible`. */
+    get_visible(): boolean;
+    /** `gtk_widget_set_visible`. */
+    set_visible(visible: boolean): void;
+    /** `gtk_widget_get_mapped`: on screen, which is in the document and rendered. */
+    get_mapped(): boolean;
+}
+export declare class TooltipElement extends WidgetElement {
+    /** `Gtk.Widget:tooltip-text`, the `tooltip-text` attribute; `null` while unset. */
+    get tooltip_text(): string | null;
+    set tooltip_text(value: string | null);
+    get tooltipText(): string | null;
+    set tooltipText(value: string | null);
+    /** `gtk_widget_get_tooltip_text`. */
+    get_tooltip_text(): string | null;
+    /** `gtk_widget_set_tooltip_text`. */
+    set_tooltip_text(text: string | null): void;
+}

package/lib/types/widget-map.spec.d.ts

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

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

@@ -0,0 +1,7 @@
+/** `gtk_widget_get_mapped`: in the document, and rendered. */
+export declare function isMapped(el: Element): boolean;
+/**
+ * Watches `el` for `map` / `unmap` while the returned function has not been called. Its present
+ * state is recorded and not emitted, as connecting a handler in GTK emits nothing.
+ */
+export declare function watchMapping(el: HTMLElement): () => void;

package/lib/types/widget-visible.spec.d.ts

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-web",
-    "version": "0.64.1",
+    "version": "0.64.2-next.254",
     "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.1",
-        "@gjsify/adwaita-fonts": "^0.64.1",
-        "@gjsify/adwaita-icons": "^0.64.1",
-        "@gjsify/gtksource-core": "^0.64.1",
+        "@gjsify/adwaita-core": "0.64.2-next.254",
+        "@gjsify/adwaita-fonts": "0.64.2-next.254",
+        "@gjsify/adwaita-icons": "0.64.2-next.254",
+        "@gjsify/gtksource-core": "0.64.2-next.254",
         "@lezer/highlight": "^1.2.3"
     },
     "peerDependencies": {
-        "@gjsify/app-settings": "^0.64.1"
+        "@gjsify/app-settings": "0.64.2-next.254"
     },
     "peerDependenciesMeta": {
         "@gjsify/app-settings": {
@@ -73,11 +73,11 @@
         }
     },
     "devDependencies": {
-        "@gjsify/app-settings": "^0.64.1",
-        "@gjsify/blueprint": "^0.64.1",
-        "@gjsify/cli": "^0.64.1",
-        "@gjsify/unit": "^0.64.1",
-        "@gjsify/vite-plugin-blueprint": "^0.64.1",
+        "@gjsify/app-settings": "0.64.2-next.254",
+        "@gjsify/blueprint": "0.64.2-next.254",
+        "@gjsify/cli": "0.64.2-next.254",
+        "@gjsify/unit": "0.64.2-next.254",
+        "@gjsify/vite-plugin-blueprint": "0.64.2-next.254",
         "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": "6c88ac780b9742fce781e9b35aa2f45c125d8064"
 }

package/scss/_about_dialog.scss

@@ -63,7 +63,9 @@ adw-about-dialog {
     }
   }
 
-  // The navigation view fills the sheet; each page is a column.
+  // The toast overlay (template `toast_overlay`) and the navigation view inside it
+  // fill the sheet; each page is a column.
+  adw-toast-overlay,
   adw-navigation-view,
   .adw-navigation-view-pages,
   .adw-navigation-page {
@@ -213,6 +215,49 @@ adw-about-dialog {
     white-space: pre-wrap;
   }
 
+  // --- What's New: the release-notes buffer (a GtkTextView with its text tags) ---
+  // Reference: adw-about-dialog.ui (release_notes_buffer tags: heading, em, code, bullet)
+  .adw-about-dialog-release-notes {
+    margin: var(--spacing-s) 0 0;
+    font-size: var(--font-size-base);
+    line-height: 1.5;
+    white-space: pre-wrap;
+
+    [data-tag='heading'] {
+      font-weight: 800;
+      font-size: 1.2em;
+    }
+
+    [data-tag='em'] {
+      font-style: italic;
+    }
+
+    [data-tag='code'] {
+      font-family: var(--monospace-font-family);
+    }
+
+    [data-tag='bullet'] {
+      opacity: var(--dim-opacity);
+    }
+  }
+
+  // --- Troubleshooting → Debugging Information ---
+  .adw-about-dialog-debug-info {
+    margin: var(--spacing-s) 0 0;
+    padding: var(--spacing-s);
+    font-family: var(--monospace-font-family);
+    font-size: var(--font-size-small);
+    white-space: pre-wrap;
+    overflow-wrap: anywhere;
+    border-radius: var(--card-radius);
+    background-color: var(--card-bg-color);
+  }
+
+  .adw-about-dialog-copy {
+    align-self: center;
+    margin-top: var(--spacing-m);
+  }
+
   .adw-about-dialog-copyright {
     margin: var(--spacing-s) 0 0;
     font-size: var(--font-size-small);

package/scss/_bin.scss

@@ -14,13 +14,16 @@
 // Modifications: Adapted for @gjsify/adwaita-web Web Components.
 
 adw-bin {
-  display: block;
+  display: flex;
+  flex-direction: column;
 
   // One child, and it fills — `gtk_bin_layout_allocate` allocates the whole widget to
   // its single child. `:only-child` rather than `> *` because a bin keeps ONE
   // (`adw_bin_set_child` unparents the one it replaces), so the case where the selector
-  // could match two is one the element has already refused.
+  // could match two is one the element has already refused. Flex stretch rather than
+  // `block-size: 100%`: a percentage needs a definite parent height, which a bin that is
+  // itself a flex item (a stack page) only has by the stretch algorithm.
   > :only-child {
-    block-size: 100%;
+    flex: 1 1 auto;
   }
 }

package/scss/_checks.scss

@@ -183,7 +183,8 @@ gtk-check-button .adw-check-indicator {
 }
 
 // `radio { border-radius: 100% }` (:73-74)
-adw-radio .adw-check-indicator {
+adw-radio .adw-check-indicator,
+gtk-check-button[radio] .adw-check-indicator {
   border-radius: 100%;
 }
 
@@ -194,7 +195,8 @@ gtk-check-button[checked] .adw-check-indicator::after {
   -webkit-mask-image: $check-glyph;
 }
 
-adw-radio[checked] .adw-check-indicator::after {
+adw-radio[checked] .adw-check-indicator::after,
+gtk-check-button[radio][checked] .adw-check-indicator::after {
   background-color: currentColor;
   mask-image: $bullet-glyph;
   -webkit-mask-image: $bullet-glyph;
@@ -206,6 +208,7 @@ adw-radio[checked] .adw-check-indicator::after {
 // specificity, same outcome here — and the same precedence `resolveCheckState`
 // in `@gjsify/adwaita-core` encodes for the a11y value.
 gtk-check-button[indeterminate] .adw-check-indicator::after,
+gtk-check-button[radio][indeterminate] .adw-check-indicator::after,
 adw-radio[indeterminate] .adw-check-indicator::after {
   background-color: currentColor;
   mask-image: $dash-glyph;

package/scss/_icon.scss

@@ -76,7 +76,7 @@
 // specificity this rule would come last and override every generated mask class
 // — every icon in the package would draw the broken glyph. `:where()` scores
 // 0,0,0, so ANY `.adw-icon--<name>` rule beats it wherever it sits in the
-// cascade, including one `registerIcon()` inserts at runtime.
+// cascade.
 :where(.adw-icon) {
   mask-image: var(--icon-image-missing);
   -webkit-mask-image: var(--icon-image-missing);
@@ -97,9 +97,8 @@
   background-color: transparent;
 }
 
-// A FULL-COLOUR icon — what `registerColorIcon()` registers and `<gtk-image>` resolves a
-// name to before (or, for `-symbolic` names, after) the symbolic glyph, in the order GTK's
-// theme tries them. It is drawn as-is, the way GTK draws `hicolor/…/apps/<app-id>.svg`: no
+// A FULL-COLOUR icon — a resource file `<gtk-image>` resolves a name to after the theme's
+// symbolic glyph, in the order GTK's theme tries them. It is drawn as-is, the way GTK draws `hicolor/…/apps/<app-id>.svg`: no
 // mask and no `currentColor` fill, only the image the element puts in `background-image`.
 //
 // The modifier is NOT `adw-icon--…`, so the rule above never sees it as a mask class.

package/scss/_labels.scss

@@ -104,8 +104,8 @@ gtk-label {
   // both cases need the same span and the same measurement pass.
   .adw-label-text {
     display: block;
-    // A pinned width, or a shrink-to-fit one, may never push the label wider than its
-    // container.
+    // A shrink-to-fit width may never push the label wider than its container.
+    // `gtk-label.ts`'s measured cap replaces this inline as `min(100%, <width>px)`.
     max-width: 100%;
   }
 

package/scss/_overlay.scss

@@ -38,13 +38,23 @@
 // Modifications: Adapted for @gjsify/adwaita-web Web Components.
 
 gtk-overlay {
-  display: block;
+  // A column flex box rather than a block: `gtk_overlay_size_allocate` hands the main child
+  // the overlay's WHOLE allocation (gtkoverlay.c), and a block would give it only its content
+  // height. With an auto height the overlay still measures as its child (the child's
+  // `flex-basis: auto` is the content), with a definite one the child grows to fill it.
+  display: flex;
+  flex-direction: column;
   position: relative;
 }
 
 .adw-overlay-child {
   // The main child, in the host's own flow — see the header.
   display: contents;
+
+  // Fill the allocation on the main axis; the cross axis stretches by default.
+  > * {
+    flex: 1 1 auto;
+  }
 }
 
 .adw-overlay-layer {

package/scss/_overlay_split_view.scss

@@ -71,6 +71,16 @@ adw-overlay-split-view {
     align-self: stretch;
   }
 
+  // Both panes are AdwBins in the C (`content_bin` / `sidebar_bin`,
+  // adw-overlay-split-view.c:1127-1138), allocated the pane's full height (:573-610,
+  // :654-690) — so the pane's widget fills it, as `_bin.scss` does for `<adw-bin>`.
+  .adw-osv-content,
+  .adw-osv-sidebar {
+    > :only-child {
+      flex: 1 1 auto;
+    }
+  }
+
   // Docked — the sidebar sits in the flex row and the hidden part is taken off
   // its own edge by a negative margin the element computes.
   &:not(.collapsed) .adw-osv-sidebar {

package/scss/_reset.scss

@@ -48,7 +48,7 @@ $adw-components:
   gtk-link-button, gtk-list-box, gtk-list-box-row, gtk-list-view, gtk-media-controls, gtk-menu-button, gtk-overlay, gtk-page-setup-unix-dialog, gtk-paned,
   gtk-password-entry, gtk-picture, gtk-popover, gtk-popover-bin, gtk-popover-menu, gtk-popover-menu-bar, gtk-print-unix-dialog,
   gtk-progress-bar, gtk-revealer, gtk-scale, gtk-scale-button, gtk-scrollbar, gtk-scrolled-window, gtk-search-bar, gtk-search-entry, gtk-separator, gtk-source-view,
-  gtk-spin-button, gtk-spinner, gtk-stack, gtk-stack-sidebar, gtk-stack-switcher, gtk-switch, gtk-text, gtk-text-view, gtk-toggle-button, gtk-tree-expander, gtk-video, gtk-viewport,
+  gtk-spin-button, gtk-spinner, gtk-stack, gtk-stack-page, gtk-stack-sidebar, gtk-stack-switcher, gtk-switch, gtk-text, gtk-text-view, gtk-toggle-button, gtk-tree-expander, gtk-video, gtk-viewport,
   gtk-window, gtk-window-controls, gtk-window-handle;
 
 // Roots: re-root the inherited typographic properties (and the box model) so a

package/scss/_scrolled_window.scss

@@ -52,8 +52,23 @@ gtk-scrolled-window {
   flex: 1 1 0%;
   overflow: hidden;
 
+  // THE CHILD IS NOT PART OF THE REQUEST on a scrolling axis: `gtk_scrolled_window_measure`
+  // reports `min-content-*` (default 0) plus the bars (gtkscrolledwindow.c:1821-1960), and adds
+  // the child's minimum only under a NEVER policy and its natural only with
+  // `propagate-natural-*` — which `_sync()` writes as an inline `width` / `height`. A zero
+  // size with `min-*: 100%` is that request in grid terms: a percentage is cyclic while the
+  // tracks are sized, so the item contributes nothing, and at layout it resolves against the
+  // cell and fills it. Without it the cell grew to the content's height, a window in a 600px
+  // box measured 2229px and had nothing left to scroll. `max-*: 100%` keeps a `max-content`
+  // request from overflowing the cell it asked for.
   > gtk-viewport {
     grid-area: 1 / 1;
+    width: 0;
+    height: 0;
+    min-width: 100%;
+    min-height: 100%;
+    max-width: 100%;
+    max-height: 100%;
   }
 
   // The vertical bar spans BOTH rows, which is `gtk_widget_size_allocate` giving it the

package/scss/_stack.scss

@@ -60,13 +60,19 @@ gtk-stack {
     // looks at the VISIBLE child alone on that axis (gtkstack.c:2899-2905) — the stack is
     // as big as the current page. Turned off, the stack is as big as the LARGEST page,
     // which is `max-content` on the cross axis and `flex: 1 1 auto` along the main one.
-    &:not([hhomogeneous]) > .adw-stack-page {
+    //
+    // The element reflects the flag as an ABSENT attribute or `=""` for TRUE and
+    // `="false"` for FALSE (`_flag`: `raw !== 'false'`, absent → the default TRUE), so
+    // only the literal `'false'` is the non-homogeneous state. `:not([hhomogeneous])`
+    // read a missing attribute as false and gave every default stack's page
+    // `width: max-content`, a zero-width page for a child with no intrinsic width.
+    &[hhomogeneous='false'] > .adw-stack-page {
         flex: 0 1 auto;
         width: max-content;
         max-width: 100%;
     }
 
-    &:not([vhomogeneous]) > .adw-stack-page {
+    &[vhomogeneous='false'] > .adw-stack-page {
         height: max-content;
         max-height: 100%;
     }

package/scss/_toast.scss

@@ -12,12 +12,22 @@
 
 adw-toast-overlay {
   position: relative;
-  display: block;
+  display: flex;
+  flex-direction: column;
 
-  // The wrapped content (Adw.ToastOverlay :child) occupies the overlay's box.
+  // The wrapped content (Adw.ToastOverlay :child) occupies the overlay's box: AdwToastOverlay
+  // allocates its child the full size (adw-toast-overlay.c size_allocate). A percentage height
+  // resolves against an indefinite one inside a block parent, so the fill is flex stretch.
   .adw-toast-overlay-content {
+    display: flex;
+    flex: 1 1 auto;
+    flex-direction: column;
+    min-height: 0;
     width: 100%;
-    height: 100%;
+
+    > * {
+      flex: 1 1 auto;
+    }
   }
 
   // The toast slot: layered over the bottom edge of the overlay and centered,

package/scss/_widget.scss

@@ -50,8 +50,12 @@
   margin-block: auto;
 }
 
+// `data-computed-*` is `gtk_widget_compute_expand` for a child that authored no value: a bin
+// whose descendant expands grows too (gtkboxlayout.c:793). `gtk-box.ts` writes it.
 gtk-box:not([orientation='vertical']) > [hexpand]:not([hexpand='false']),
-gtk-box[orientation='vertical'] > [vexpand]:not([vexpand='false']) {
+gtk-box[orientation='vertical'] > [vexpand]:not([vexpand='false']),
+gtk-box:not([orientation='vertical']) > [data-computed-hexpand],
+gtk-box[orientation='vertical'] > [data-computed-vexpand] {
   flex-grow: 1;
 }
 

package/scss/_window.scss

@@ -43,6 +43,15 @@ adw-application-window {
     box-shadow: none;
   }
 
+  // A maximized or fullscreen window ignores its default size and fills the work area
+  // (gtkwindow.c); on a page that is the containing block. The element drops its inline
+  // `default-width`/`default-height` in these states so this can apply, and keeps the minimum.
+  &[maximized]:not([maximized="false"]),
+  &[fullscreened]:not([fullscreened="false"]) {
+    width: 100%;
+    height: 100%;
+  }
+
   // `present()` and `hide-on-close` toggle `hidden`, which `display: flex` would override.
   &[hidden] {
     display: none;
@@ -110,6 +119,13 @@ gtk-application-window {
     box-shadow: none;
   }
 
+  // The same fill as `adw-window` above: the default size is only the restored size.
+  &[maximized]:not([maximized="false"]),
+  &[fullscreened]:not([fullscreened="false"]) {
+    width: 100%;
+    height: 100%;
+  }
+
   // The strip: an application's `titlebar` slot, or the two window-control groups and the
   // window's own title. `min-width: 0` on the title is what lets a long one ellipsize
   // instead of pushing the end controls out of the frame.

package/src/accessible.ts

@@ -0,0 +1,29 @@
+// The accessible name and description of a widget whose ROLE lives on an inner control.
+//
+// A `.blp`'s `accessibility { label: …; description: …; }` reaches this renderer as the host's
+// `aria-label` / `aria-description` (`shared-tree-builder.ts`). Where the host itself carries
+// the role that is the whole door. `<gtk-button>` and `<gtk-check-button>` do not: the role is
+// on the inner `<button>` / `<input>`, and an `aria-label` on a role-less host is one no
+// assistive technology reads. Those elements observe both attributes and copy them onto the
+// control here, so `GTK_ACCESSIBLE_PROPERTY_LABEL` lands where GTK's lands: on the widget that
+// is announced.
+//
+// Reference: refs/gtk/gtk/gtkaccessible.c (gtk_accessible_update_property)
+// Copyright (c) GNOME contributors (GTK). LGPLv2.1+.
+
+/** The `accessibility { }` names a host forwards: `label` and `description`, as ARIA spells them. */
+export const FORWARDED_ARIA = ['aria-label', 'aria-description'] as const;
+
+/**
+ * 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 function forwardAccessibleName(host: Element, control: Element): boolean {
+    for (const name of FORWARDED_ARIA) {
+        const value = host.getAttribute(name);
+        if (value === null) control.removeAttribute(name);
+        else control.setAttribute(name, value);
+    }
+    return host.hasAttribute('aria-label');
+}

package/src/adw-about-dialog.spec.ts

@@ -7,21 +7,27 @@
 // and `website` is the one input the Details-visibility predicate leaves OUT.
 import { describe, expect, it } from '@gjsify/unit';
 
-import { ADW_ABOUT_DIALOG_LABELS, stripMnemonic } from '@gjsify/adwaita-core';
+import { ADW_ABOUT_DIALOG_LABELS, type ReleaseNotesSegment, type Toast, stripMnemonic } from '@gjsify/adwaita-core';
 import {
     ABOUT_DIALOG_CREDITS_LEGAL_VECTORS,
     ABOUT_DIALOG_DETAILS_VECTORS,
+    ABOUT_DIALOG_DOOR_VECTORS,
     ABOUT_DIALOG_HEADER_VECTORS,
     ABOUT_DIALOG_SUPPORT_VECTORS,
+    type AboutDialogDoorLike,
     CREDITS_SECTIONS_VECTORS,
     CREDIT_PERSON_VECTORS,
+    RELEASE_NOTES_VECTORS,
+    driveAboutDialogDoorVectors,
+    driveReleaseNotesVectors,
 } from '@gjsify/adwaita-core/conformance';
 
 /** The label a renderer without an accelerator layer paints for a row. */
 const label = (key: keyof typeof ADW_ABOUT_DIALOG_LABELS) => stripMnemonic(ADW_ABOUT_DIALOG_LABELS[key]);
 
 interface Mounted {
-    dialog: HTMLElement & { developers: string[]; designers: string[]; artists: string[]; documenters: string[] };
+    dialog: HTMLElement &
+        AboutDialogDoorLike & { developers: string[]; designers: string[]; artists: string[]; documenters: string[] };
     host: HTMLElement;
     /** Every `window.open` the dialog performed, most recent last. */
     opened: string[];
@@ -157,22 +163,23 @@ export const AdwAboutDialogTest = async () => {
     });
 
     await describe('adw-about-dialog main page (update_details vectors)', async () => {
-        // `add_link` has no counterpart on this element, so `has_custom_links`
-        // is always FALSE here; those rows are asserted by the core suite.
-        for (const vector of ABOUT_DIALOG_DETAILS_VECTORS.filter((row) => !row.customLinks && !row.releaseNotes)) {
-            const { website, comments, visible, rule } = vector;
-            await it(`website=${website} comments=${comments} — ${rule}`, () => {
+        for (const vector of ABOUT_DIALOG_DETAILS_VECTORS) {
+            const { website, comments, customLinks, releaseNotes, visible, rule } = vector;
+            await it(`website=${website} comments=${comments} links=${customLinks} notes=${releaseNotes} — ${rule}`, () => {
                 const mounted = mount({
                     'application-name': 'Builder',
                     ...(website ? { website: 'https://example.org' } : {}),
                     ...(comments ? { comments: 'A description.' } : {}),
+                    ...(releaseNotes ? { 'release-notes': '<p>Hi</p>' } : {}),
                 });
+                if (customLinks) mounted.dialog.add_link('_Docs', 'https://example.org/docs');
 
                 const main = page(mounted.dialog, 'main');
                 const details = page(mounted.dialog, 'details');
 
                 expect({
                     detailsGroup: group(mounted.dialog, 'details') !== null,
+                    whatsNewRow: hasRow(main, label('whatsNewRow')),
                     detailsRow: hasRow(main, label('detailsRow')),
                     websiteRow: hasRow(main, label('websiteRow')),
                     commentsLabel: details?.querySelector('.adw-about-dialog-comments') != null,
@@ -180,6 +187,7 @@ export const AdwAboutDialogTest = async () => {
                     detailsWebsiteRow: hasRow(details, label('websiteRow')),
                 }).toStrictEqual({
                     detailsGroup: visible.detailsGroup,
+                    whatsNewRow: visible.whatsNewRow,
                     detailsRow: visible.detailsRow,
                     websiteRow: visible.websiteRow,
                     commentsLabel: visible.commentsLabel,
@@ -203,15 +211,14 @@ export const AdwAboutDialogTest = async () => {
     });
 
     await describe('adw-about-dialog main page (update_support vectors)', async () => {
-        // debug-info has no counterpart here (no Troubleshooting page), so the core
-        // suite asserts those rows.
-        for (const vector of ABOUT_DIALOG_SUPPORT_VECTORS.filter((row) => !row.debugInfo)) {
-            const { supportUrl, issueUrl, visible, rule } = vector;
-            await it(`support=${supportUrl} issue=${issueUrl} — ${rule}`, () => {
+        for (const vector of ABOUT_DIALOG_SUPPORT_VECTORS) {
+            const { supportUrl, issueUrl, debugInfo, visible, rule } = vector;
+            await it(`support=${supportUrl} issue=${issueUrl} debug=${debugInfo} — ${rule}`, () => {
                 const mounted = mount({
                     'application-name': 'Builder',
                     ...(supportUrl ? { 'support-url': 'https://example.org/help' } : {}),
                     ...(issueUrl ? { 'issue-url': 'https://example.org/issues' } : {}),
+                    ...(debugInfo ? { 'debug-info': 'GTK 4.20' } : {}),
                 });
 
                 const main = page(mounted.dialog, 'main');
@@ -219,10 +226,12 @@ export const AdwAboutDialogTest = async () => {
                     supportGroup: group(mounted.dialog, 'support') !== null,
                     supportRow: hasRow(main, label('supportRow')),
                     issueRow: hasRow(main, label('issueRow')),
+                    troubleshootingRow: hasRow(main, label('troubleshootingRow')),
                 }).toStrictEqual({
                     supportGroup: visible.supportGroup,
                     supportRow: visible.supportRow,
                     issueRow: visible.issueRow,
+                    troubleshootingRow: visible.troubleshootingRow,
                 });
 
                 mounted.dispose();
@@ -340,6 +349,66 @@ export const AdwAboutDialogTest = async () => {
         });
     });
 
+    // The notes, debug and link doors, on the vectors real `gi://Adw` passes.
+    const doorMounts: Mounted[] = [];
+    const doorSubject = {
+        name: 'adw-about-dialog',
+        isOracle: false,
+        labels: { ...ADW_ABOUT_DIALOG_LABELS, websiteRow: label('websiteRow') },
+        isGLibUntranslated: true,
+        makeDialog(): AboutDialogDoorLike {
+            const mounted = mount({ 'application-name': 'Builder' });
+            doorMounts.push(mounted);
+            return mounted.dialog;
+        },
+        whatsNew(dialog: AboutDialogDoorLike): ReleaseNotesSegment[] {
+            const notes =
+                page(dialog as Mounted['dialog'], 'whatsnew')?.querySelectorAll(
+                    '.adw-about-dialog-release-notes > span',
+                ) ?? [];
+            return [...notes].map((span) => ({
+                text: span.textContent ?? '',
+                tag: (span.dataset['tag'] ?? null) as ReleaseNotesSegment['tag'],
+            }));
+        },
+        isRowVisible(dialog: AboutDialogDoorLike, row: 'whatsNewRow' | 'detailsRow' | 'troubleshootingRow'): boolean {
+            return hasRow(page(dialog as Mounted['dialog'], 'main'), label(row));
+        },
+        debugInfoText(dialog: AboutDialogDoorLike): string {
+            return (dialog as Mounted['dialog']).querySelector('pre.adw-about-dialog-debug-info')?.textContent ?? '';
+        },
+        linkTitles(dialog: AboutDialogDoorLike): string[] {
+            return rowTitles(group(dialog as Mounted['dialog'], 'links'));
+        },
+        dispose() {
+            for (const mounted of doorMounts.splice(0)) mounted.dispose();
+        },
+    };
+    await driveReleaseNotesVectors(doorSubject, { describe, it, expect }, RELEASE_NOTES_VECTORS);
+    await driveAboutDialogDoorVectors(doorSubject, { describe, it, expect }, ABOUT_DIALOG_DOOR_VECTORS);
+
+    await describe('adw-about-dialog new_from_appdata and Copy Text', async () => {
+        await it('refuses new_from_appdata by name', () => {
+            const ctor = customElements.get('adw-about-dialog') as unknown as {
+                new_from_appdata(path: string): unknown;
+            };
+            expect(() => ctor.new_from_appdata('/org/example/App/metainfo.xml')).toThrow(
+                'Adw.AboutDialog.new_from_appdata',
+            );
+        });
+
+        await it('shows the Copied toast when Copy Text copies the debug info', () => {
+            const mounted = mount({ 'application-name': 'Builder', 'debug-info': 'GTK 4.20' });
+            const copy = page(mounted.dialog, 'debuginfo')!.querySelector('.adw-about-dialog-copy') as HTMLElement;
+            copy.click();
+            const overlay = mounted.dialog.querySelector('adw-toast-overlay') as unknown as {
+                currentToast: Toast | null;
+            };
+            expect(overlay.currentToast?.title).toBe(ADW_ABOUT_DIALOG_LABELS.copiedToast);
+            mounted.dispose();
+        });
+    });
+
     // An opened dialog has to OCCUPY SPACE, and no other test here can see that: they
     // all read the built DOM, and all passed while the sheet measured 360×0.
     //

package/src/adw-action-rows.spec.ts

@@ -28,8 +28,8 @@ import {
 
 import { normalizeIconName } from '@gjsify/adwaita-core';
 
-import { isIconAvailable } from './icon-registry.js';
-import { fallbackMask, maskOf } from './icon-registry.spec.js';
+import { isIconAvailable } from './icon-theme.js';
+import { fallbackMask, maskOf } from './icon-masks.spec.js';
 
 import type { AdwActionRow } from './elements/adw-action-row.js';
 import type { AdwComboRow } from './elements/adw-combo-row.js';