@gjsify/adwaita-web 0.64.2-next.252 → 0.64.2-next.255

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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-web",
-    "version": "0.64.2-next.252",
+    "version": "0.64.2-next.255",
     "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.2-next.252",
-        "@gjsify/adwaita-fonts": "0.64.2-next.252",
-        "@gjsify/adwaita-icons": "0.64.2-next.252",
-        "@gjsify/gtksource-core": "0.64.2-next.252",
+        "@gjsify/adwaita-core": "0.64.2-next.255",
+        "@gjsify/adwaita-fonts": "0.64.2-next.255",
+        "@gjsify/adwaita-icons": "0.64.2-next.255",
+        "@gjsify/gtksource-core": "0.64.2-next.255",
         "@lezer/highlight": "^1.2.3"
     },
     "peerDependencies": {
-        "@gjsify/app-settings": "0.64.2-next.252"
+        "@gjsify/app-settings": "0.64.2-next.255"
     },
     "peerDependenciesMeta": {
         "@gjsify/app-settings": {
@@ -73,11 +73,11 @@
         }
     },
     "devDependencies": {
-        "@gjsify/app-settings": "0.64.2-next.252",
-        "@gjsify/blueprint": "0.64.2-next.252",
-        "@gjsify/cli": "0.64.2-next.252",
-        "@gjsify/unit": "0.64.2-next.252",
-        "@gjsify/vite-plugin-blueprint": "0.64.2-next.252",
+        "@gjsify/app-settings": "0.64.2-next.255",
+        "@gjsify/blueprint": "0.64.2-next.255",
+        "@gjsify/cli": "0.64.2-next.255",
+        "@gjsify/unit": "0.64.2-next.255",
+        "@gjsify/vite-plugin-blueprint": "0.64.2-next.255",
         "sass": "^1.101.0",
         "typescript": "^6.0.3"
     },
@@ -115,5 +115,5 @@
         "url": "https://github.com/gjsify/gjsify/issues"
     },
     "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/web/adwaita-web#readme",
-    "gitHead": "3853c65f772d30460e3894ff08a6079a70d7b206"
+    "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/_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_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/_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/_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/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';

package/src/adw-button-content.spec.ts

@@ -20,7 +20,7 @@ import {
     BUTTON_CONTENT_TEXT_VECTORS,
 } from '@gjsify/adwaita-core/conformance';
 import type { AdwButtonContent } from './elements/adw-button-content.js';
-import { fallbackMask, maskOf } from './icon-registry.spec.js';
+import { fallbackMask, maskOf } from './icon-masks.spec.js';
 
 /** Mount a button content inside a plain Adwaita button, the way the stories do. */
 function mount(attributes: Record<string, string> = {}): {

package/src/adw-carousel.spec.ts

@@ -11,11 +11,13 @@ import { describe, expect, it } from '@gjsify/unit';
 
 import type { CarouselPageMeasurement } from '@gjsify/adwaita-core';
 import {
+    CAROUSEL_DOOR_VECTORS,
     CAROUSEL_PAGE_ALLOCATION_VECTORS,
     CAROUSEL_PAGE_AT_POSITION_VECTORS,
     CAROUSEL_PAGE_LIST_VECTORS,
+    driveCarouselDoorVectors,
 } from '@gjsify/adwaita-core/conformance';
-import type { CarouselPageOp } from '@gjsify/adwaita-core/conformance';
+import type { CarouselDoorLike, CarouselPageOp } from '@gjsify/adwaita-core/conformance';
 
 /** The carousel surface this suite drives — the element's own public API. */
 interface CarouselElement extends HTMLElement {
@@ -513,4 +515,50 @@ export const AdwCarouselTest = async () => {
             host.remove();
         });
     });
+
+    // The GIR doors, on the vectors real `gi://Adw` passes. `mount` makes the animated
+    // scroll instant too, so `settle` waits for the rAF-throttled read-back only.
+    const hosts: HTMLElement[] = [];
+    await driveCarouselDoorVectors(
+        {
+            name: 'adw-carousel',
+            isOracle: false,
+            makeCarousel(count) {
+                const { carousel, host } = mount(Array.from({ length: count }, (_unused, i) => `p${i}`));
+                hosts.push(host);
+                const pages = Array.from(carousel.querySelectorAll('.adw-carousel-page')).map(
+                    (slot) => slot.firstElementChild as HTMLElement,
+                );
+                return { carousel: carousel as unknown as CarouselDoorLike, pages };
+            },
+            makeStranger: () => card('stranger'),
+            async settle() {
+                await flush();
+                await flush();
+            },
+            dispose() {
+                for (const host of hosts.splice(0)) host.remove();
+            },
+        },
+        { describe, it, expect },
+        CAROUSEL_DOOR_VECTORS,
+    );
+
+    await describe('adw-carousel scroll_to before the pages are adopted', async () => {
+        await it('lands where a declared position would, as upstream defers it to an idle', async () => {
+            const carousel = document.createElement('adw-carousel') as CarouselElement & CarouselDoorLike;
+            carousel.style.cssText = 'display:block;width:200px;height:80px;';
+            const pages = ['a', 'b', 'c'].map((label) => card(label));
+            for (const page of pages) carousel.appendChild(page);
+            expect(carousel.get_n_pages()).toBe(3);
+            expect(carousel.get_nth_page(2)).toBe(pages[2]);
+            carousel.scroll_to(pages[2], false);
+
+            document.body.appendChild(carousel);
+            await flush();
+            await flush();
+            expect(carousel.get_position()).toBe(2);
+            carousel.remove();
+        });
+    });
 };

package/src/capabilities.mjs

@@ -5,6 +5,7 @@
 /** @type {import('./capabilities.d.mts').capabilities} */
 export const capabilities = {
     layout: 'implemented',
+    accessibility: 'implemented',
     strings: 'implemented',
     responses: 'implemented',
     page: 'implemented',

package/src/checks.spec.ts

@@ -12,9 +12,10 @@
 // so two scenarios sharing the literal name `colour` would share a selection.
 
 import { describe, expect, it } from '@gjsify/unit';
-import { RADIO_GROUP_VECTORS } from '@gjsify/adwaita-core/conformance';
+import { RADIO_GROUP_VECTORS, driveCheckGroupVectors, type CheckButtonLike } from '@gjsify/adwaita-core/conformance';
 
 import type { GtkCheckButton, AdwRadio } from './elements/checks.js';
+import { buildSharedTree } from './shared-tree-builder.js';
 
 function host(): HTMLElement {
     const el = document.createElement('div');
@@ -354,4 +355,53 @@ export const AdwChecksTest = async () => {
             parent.remove();
         });
     });
+
+    await describe('<gtk-check-button> group (CHECK_GROUP_VECTORS)', async () => {
+        await driveCheckGroupVectors(
+            {
+                name: 'adwaita-web',
+                isOracle: false,
+                make: () => mountCheckbox().el as unknown as CheckButtonLike,
+                activate: (button) => parts(button as unknown as HTMLElement).indicator.click(),
+                countToggled(button) {
+                    let count = 0;
+                    (button as unknown as HTMLElement).addEventListener('toggled', () => void (count += 1));
+                    return () => count;
+                },
+            },
+            { describe, it, expect },
+        );
+
+        await it('a grouped button draws the radio and its input announces role=radio', () => {
+            const [a, b] = [mountCheckbox().el, mountCheckbox().el];
+            b.set_group(a);
+            expect([a.hasAttribute('radio'), parts(b).input.getAttribute('role')].join()).toBe('true,radio');
+            b.set_group(null);
+            expect([a.hasAttribute('radio'), b.hasAttribute('radio'), parts(b).input.hasAttribute('role')].join()).toBe(
+                'true,false,false',
+            );
+        });
+
+        await it('a projected `group: follow` resolves by id once the tree is in the document', () => {
+            const tree = buildSharedTree({
+                tag: 'GtkBox',
+                children: [
+                    { tag: 'GtkCheckButton', id: 'group-follow', props: { active: true } },
+                    { tag: 'GtkCheckButton', id: 'group-dark', props: { group: 'group-follow' } },
+                ],
+            });
+            host().appendChild(tree);
+            const [follow, dark] = ['group-follow', 'group-dark'].map(
+                (id) => document.getElementById(id) as GtkCheckButton,
+            );
+            dark.set_active(true);
+            expect([follow.get_active(), dark.get_active()].join()).toBe('false,true');
+        });
+
+        await it('a group id nothing carries is refused', () => {
+            const el = document.createElement('gtk-check-button') as GtkCheckButton;
+            el.setAttribute('group', 'group-nowhere');
+            expect(() => (el as unknown as { connectedCallback(): void }).connectedCallback()).toThrow();
+        });
+    });
 };