@gjsify/adwaita-web 0.45.0 → 0.47.0

package/src/icon-registry.spec.ts

@@ -1,4 +1,4 @@
-// What an icon actually DRAWS — the assertion `adw-icon.spec.ts` did not make.
+// What an icon actually DRAWS — the assertion `gtk-image.spec.ts` did not make.
 //
 // THE INCIDENT. `_icon.scss` set `background-color: currentColor` plus mask sizing and no
 // `mask-image`, so a name outside the compiled `.adw-icon--<name>` set painted a solid 16px
@@ -15,7 +15,7 @@
 import { describe, expect, it } from '@gjsify/unit';
 
 import { isIconAvailable, registerIcon } from './icon-registry.js';
-import type { AdwIcon } from './elements/adw-icon.js';
+import type { GtkImage } from './elements/gtk-image.js';
 
 /** A name no compiled entry can collide with, for the "not shipped" arm. */
 const ABSENT = 'gjsify-registry-probe';
@@ -25,10 +25,10 @@ const PROBE_SVG = `<svg height="16px" viewBox="0 0 16 16" width="16px" xmlns="ht
     <path d="m 4 4 h 8 v 8 h -8 z m 0 0" fill="currentColor"/>
 </svg>`;
 
-function mount(iconName: string | null): { el: AdwIcon; host: HTMLElement } {
+function mount(iconName: string | null): { el: GtkImage; host: HTMLElement } {
     const host = document.createElement('div');
     document.body.appendChild(host);
-    const el = document.createElement('adw-icon') as AdwIcon;
+    const el = document.createElement('gtk-image') as GtkImage;
     if (iconName !== null) el.iconName = iconName;
     host.appendChild(el);
     return { el, host };
@@ -56,7 +56,7 @@ export function fallbackMask(): string {
 }
 
 export const AdwIconRegistryTest = async () => {
-    await describe('<adw-icon> resolves a name to a real mask', async () => {
+    await describe('<gtk-image> resolves a name to a real mask', async () => {
         await it('a compiled name draws its OWN glyph, not the fallback', () => {
             const { el, host } = mount('go-next');
             const mask = maskOf(el);
@@ -111,7 +111,7 @@ export const AdwIconRegistryTest = async () => {
 
     await describe('a name carried by STATE still resolves', async () => {
         await it("the password row's peek toggle draws both of its glyphs", () => {
-            // These two reach `<adw-icon>.iconName` as `state.peekIconName`, a property of
+            // These two reach `<gtk-image>.iconName` as `state.peekIconName`, a property of
             // the core's `PasswordEntryRowState`, so no literal spells them at the point of
             // use. `check-adwaita-icon-masks.mjs` reads their DECLARATIONS
             // (`PASSWORD_REVEAL_ICON_NAME`), which proves the map entry exists — never that

package/src/icon-registry.ts

@@ -10,16 +10,16 @@
 // That is this module. `registerIcon` writes the SAME pair the generator writes — the
 // custom property on the document element, the mask class into a stylesheet this module
 // owns — so a registered icon is indistinguishable from a compiled one at every later
-// point: `<adw-icon icon-name="…">`, a hand-written `class="adw-icon adw-icon--…"`, a
+// point: `<gtk-image icon-name="…">`, a hand-written `class="adw-icon adw-icon--…"`, a
 // widget attribute, `var(--icon-…)` in the consumer's own CSS.
 //
 //   import { registerIcon } from '@gjsify/adwaita-web';
 //   import { dialogErrorSymbolic } from '@gjsify/adwaita-icons/status';
 //
 //   registerIcon('dialog-error-symbolic', dialogErrorSymbolic);
-//   // …then anywhere: <adw-icon icon-name="dialog-error-symbolic"></adw-icon>
+//   // …then anywhere: <gtk-image icon-name="dialog-error-symbolic"></gtk-image>
 //
-// Register BEFORE the icon is mounted where you can. An `<adw-icon>` already in the
+// Register BEFORE the icon is mounted where you can. A `<gtk-image>` already in the
 // document draws the `image-missing` fallback (see `_icon.scss`) until the registration
 // lands; the CSS is live, so it corrects itself on the next style recalculation with no
 // re-render, but there is a visible frame in between.
@@ -30,7 +30,7 @@
 import { normalizeIconName } from '@gjsify/adwaita-core';
 import { toDataUri } from '@gjsify/adwaita-icons/utils';
 
-import { MASK_CLASS_PREFIX } from './elements/adw-icon.js';
+import { MASK_CLASS_PREFIX } from './elements/gtk-image.js';
 
 /** Marks the one `<style>` element this module owns, so a reload reuses it. */
 const REGISTRY_STYLE_ID = 'adwaita-web-icon-registry';
@@ -96,8 +96,8 @@ function svgRootOf(source: string): Element {
  * BOTH arguments are checked and a wrong one THROWS rather than registering nothing: unlike
  * a render, this is an explicit call with a wrong argument, and silently doing nothing is
  * the failure mode this whole area exists to end. The name is normalized exactly as
- * `<adw-icon icon-name>` normalizes it — a single `-symbolic` suffix comes off, and the rest
- * must be one CSS token; the SVG has to parse to an `<svg>` root. `<adw-icon>` draws
+ * `<gtk-image icon-name>` normalizes it — a single `-symbolic` suffix comes off, and the rest
+ * must be one CSS token; the SVG has to parse to an `<svg>` root. `<gtk-image>` draws
  * `image-missing` for the same unusable name instead — there it came from markup, and
  * taking the page down over a typo is not proportionate.
  *

package/src/index.ts

@@ -63,8 +63,42 @@ export type { AdwUndershootEdges } from './scroll-shading.js';
 // `icon-registry.ts` for the full recipe.
 export { isIconAvailable, registerIcon } from './icon-registry.js';
 
-export { AdwAvatar } from './elements/adw-avatar.js';
-export { AdwBanner } from './elements/adw-banner.js';
+// THE WIDGET CLASSES ARE REACHABLE ONLY AS `Adw.<Name>` / `Gtk.<Name>` (ADR 0034
+// clause 2 + § Amendment 6). The namespace used to be the LAST line in the file, under a
+// run of `export { AdwActionRow } …` re-exports it duplicated one for one; those are
+// gone, and with them the second spelling. `<adw-action-row>` and `<gtk-entry>` are
+// unchanged — this was never about the tags.
+//
+// IT IS ALSO WHAT PULLS THE ELEMENT MODULES IN, so importing this barrel still
+// registers everything. The old order comment ("exported before the widgets that build
+// them") described a sequence that is not load-bearing and never was: every host
+// imports its prerequisite itself (`import './gtk-switch.js'` in the switch rows,
+// `createGtkImage` from `./gtk-image.js` in every widget that draws an icon), so the
+// module graph fixes the order whatever a barrel does. The order that IS load-bearing
+// is the one inside a single module, and `scripts/check-adwaita-upgrade-order.mjs`
+// holds that.
+//
+// `export * as`, NOT an object literal, and that is a bundler constraint rather than a
+// preference: a module namespace carries the TYPE meaning of every name in it, so
+// `as Adw.HeaderBar` works with no second list of instance types — and the merge that
+// would have produced those types (`export const Adw` beside `export namespace Adw`) is
+// a PARSE_ERROR in rolldown's oxc parser even though `tsc` accepts it. The reasoning is
+// in `namespace/adw.ts`.
+export * as Adw from './namespace/adw.js';
+export * as Gtk from './namespace/gtk.js';
+
+// WHAT DID NOT MOVE INTO THE NAMESPACE, and the rule that decides it. A member exists
+// for an element whose GIR tag names a real widget; `WEB_ELEMENT_ALIGNMENT` declares the
+// rest `webOnly`, meaning no widget in the reference vocabulary stands behind it, so
+// there is no GIR name to export it under and inventing one would be held against
+// nothing but prose (ADR 0034 § 5). Those classes therefore keep their flat name, and
+// that is not a second spelling: it is their only one.
+//
+// Everything else below is not a widget class at all — a factory, a helper, or a type —
+// and a type has no namespace member to move to.
+
+// Two elements with no GTK counterpart: `.adw-card` is a style class here and a styled
+// container on GTK, and the grid is presentational where GTK would use a plain Gtk.Grid.
 export { AdwCard } from './elements/adw-card.js';
 export { AdwDataGrid } from './elements/adw-data-grid.js';
 export type {
@@ -73,66 +107,33 @@ export type {
     AdwDataGridRow,
     AdwDataGridRowVariant,
 } from './elements/adw-data-grid.js';
-export { AdwClamp } from './elements/adw-clamp.js';
-export { AdwSpinner } from './elements/adw-spinner.js';
-export { AdwStatusPage } from './elements/adw-status-page.js';
-export { AdwWindow } from './elements/adw-window.js';
-export { AdwHeaderBar } from './elements/adw-header-bar.js';
-export { AdwWindowTitle } from './elements/adw-window-title.js';
-export { AdwButton } from './elements/adw-button.js';
-export { AdwButtonContent } from './elements/adw-button-content.js';
-// The ONE symbolic-icon node and the ONE toggle, exported before the widgets that build
-// them so the barrel's definition order matches theirs. Each host ALSO imports them
-// directly, which is what actually guarantees the tags are defined before a
-// server-rendered host upgrades.
-export { AdwIcon, createAdwIcon } from './elements/adw-icon.js';
-export { AdwSwitch } from './elements/adw-switch.js';
-// The two form-control primitives. ONE module, because upstream merges their
-// stylesheet (`_checks.scss`; there is no `_radio.scss` in libadwaita) and
-// everything but the corner radius, the glyph and the group is shared.
-export { AdwCheckbox, AdwRadio } from './elements/adw-checks.js';
-// The determinate progress indicator — <adw-spinner> covers only the indeterminate case.
-export { AdwProgressBar } from './elements/adw-progress-bar.js';
-// A keyboard shortcut, drawn as keycaps. The accelerator GRAMMAR lives in
-// @gjsify/adwaita-core; this element only builds the nodes.
-export { AdwShortcutLabel } from './elements/adw-shortcut-label.js';
-// The ONE popover surface, exported before its three hosts for the same reason as
-// <adw-icon> above.
-export { AdwPopover } from './elements/adw-popover.js';
-export type { AdwPopoverAlign, AdwPopoverPosition, AdwPopoverRole } from './elements/adw-popover.js';
-export { AdwSplitButton } from './elements/adw-split-button.js';
-export { AdwToggle, AdwToggleGroup } from './elements/adw-toggle-group.js';
-export { AdwEntry } from './elements/adw-entry.js';
-export { AdwPreferencesGroup } from './elements/adw-preferences-group.js';
-export { AdwActionRow } from './elements/adw-action-row.js';
-export { AdwEntryRow } from './elements/adw-entry-row.js';
-export { AdwSwitchRow } from './elements/adw-switch-row.js';
-export { AdwComboRow } from './elements/adw-combo-row.js';
-export { AdwSpinRow } from './elements/adw-spin-row.js';
-export { AdwButtonRow } from './elements/adw-button-row.js';
-export { AdwExpanderRow } from './elements/adw-expander-row.js';
-export { AdwPasswordEntryRow } from './elements/adw-password-entry-row.js';
-export { AdwToastOverlay } from './elements/adw-toast-overlay.js';
-export { AdwToolbarView } from './elements/adw-toolbar-view.js';
-export { AdwWrapBox } from './elements/adw-wrap-box.js';
-export { AdwOverlaySplitView } from './elements/adw-overlay-split-view.js';
-export { AdwNavigationSplitView } from './elements/adw-navigation-split-view.js';
-export { AdwCarousel, AdwCarouselIndicatorDots, AdwCarouselIndicatorLines } from './elements/adw-carousel.js';
-export { AdwTabPage, AdwTabView } from './elements/adw-tab-view.js';
-export { AdwViewSwitcher, AdwViewSwitcherPage } from './elements/adw-view-switcher.js';
-export { AdwInlineViewSwitcher, AdwViewStackPage } from './elements/adw-inline-view-switcher.js';
-export { AdwViewStack } from './elements/adw-view-stack.js';
+
+// The symbolic-icon FACTORY. `Gtk.Image` is the element; this builds one without a tag,
+// which the icon-drawing element modules use internally and a consumer with its own
+// chrome needs.
+export { createGtkImage } from './elements/gtk-image.js';
+
+// GTK4 has no radio TYPE — a radio is a GtkCheckButton with its `group` set — so
+// `Gtk.CheckButton` is the plain form and the grouped one has only this name.
+export { AdwRadio } from './elements/checks.js';
+
+// The declarative children of four composites. Each descends from `GObject.Object` and
+// not `GtkWidget` on GTK, so the table of concrete widgets has no row for them; the day
+// it grows one, its member appears in `namespace.ts` by itself.
+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';
+
+// Slot wrappers and a declarative response: on GTK these are `set_content()`,
+// `set_sheet()` and `add_response()` — calls, not widgets.
+export { AdwBottomSheetContent, AdwBottomSheetSheet } from './elements/adw-bottom-sheet.js';
+export { AdwAlertResponse } from './elements/adw-alert-dialog.js';
+
+// Supporting types — the option bags, enums and unions the widgets above take and
+// return. Not widgets, so clause 2 has nothing to say about them.
+export type { GtkPopoverAlign, GtkPopoverPosition, GtkPopoverRole } from './elements/gtk-popover.js';
 export type { AdwViewStackPageInfo } from './elements/adw-view-stack.js';
-export { AdwViewSwitcherBar } from './elements/adw-view-switcher-bar.js';
-export { AdwMenuButton } from './elements/adw-menu-button.js';
-export type { AdwMenuItem } from './elements/adw-menu-button.js';
-export { AdwDropDown } from './elements/adw-drop-down.js';
-export type { AdwDropDownOption } from './elements/adw-drop-down.js';
-export { AdwNavigationPage, AdwNavigationView } from './elements/adw-navigation-view.js';
-export { AdwBottomSheet, AdwBottomSheetContent, AdwBottomSheetSheet } from './elements/adw-bottom-sheet.js';
-export { AdwSidebar, AdwSidebarItem, AdwSidebarSection } from './elements/adw-sidebar.js';
-export { AdwAboutDialog } from './elements/adw-about-dialog.js';
-export { AdwAlertDialog, AdwAlertResponse } from './elements/adw-alert-dialog.js';
-export { AdwPreferencesDialog, AdwPreferencesPage } from './elements/adw-preferences-dialog.js';
-export { AdwDialog } from './elements/adw-dialog.js';
+export type { AdwMenuItem } from './elements/gtk-menu-button.js';
+export type { GtkDropDownOption } from './elements/gtk-drop-down.js';
 export type { AdwDialogPresentationMode } from './elements/adw-dialog.js';

package/src/namespace/adw.ts

@@ -0,0 +1,99 @@
+// The libadwaita half of `@gjsify/adwaita-web`'s vocabulary — `Adw.ActionRow`,
+// `Adw.Clamp`, one member per element whose own tag is an `adw-*` tag in the GIR.
+// `export * as Adw from './namespace/adw.js'` in `src/index.ts` turns this module into
+// the namespace object.
+//
+// ADR 0034 clause 2, and since § Amendment 6 this is the ONLY way to reach one of these
+// widget classes: the prefixed `AdwActionRow` / `GtkEntry` exports are gone from the
+// package root. The TAGS are untouched — `<adw-action-row>` and `<gtk-entry>` are what
+// they were, and nothing here changes a registration.
+//
+// It landed additive, and the amendment says why that could not be the end state: a
+// second spelling that never goes away is a permanent second vocabulary, which is the
+// thing clause 2 exists to remove.
+//
+// WHICH NAMESPACE A MEMBER LANDS IN IS NOT A CHOICE MADE HERE. It is read off the GIR tag
+// the element already answers to, which is clause 1 applied rather than restated:
+//
+//   * the element's own spelling IS a tag in gtk-host's generated widget table
+//     (`adw-action-row`) -> libadwaita owns the GType -> `Adw.ActionRow`, this file;
+//   * the element is declared in `WEB_ELEMENT_ALIGNMENT` as an alias of a `gtk-*` tag
+//     (`<adw-entry>` is `gtk-entry`) -> GTK owns the GType -> `Gtk.Entry`, `./gtk.ts`.
+//     On those the `adw-` prefix names the design system and not the widget, which is
+//     what each entry's `why` already says; exporting them under `Adw` would carry the
+//     flattening this ADR exists to undo one indirection further in.
+//
+// THE `webOnly` ELEMENTS GET NO MEMBER, and that absence IS the declaration. A
+// `webOnly` entry says no widget in the reference vocabulary stands behind the element,
+// so there is no GIR name to export it under; a member invented for one could only ever
+// be held against this repository's own prose, which ADR 0034 § 5 names as the half that
+// cannot go red. Some of them do name a real libadwaita GType — `AdwTabPage`,
+// `AdwViewStackPage`, `AdwSidebarItem`, `AdwSidebarSection` descend from `GObject.Object`
+// and not `GtkWidget`, so a table of concrete widgets has no row for them — and they are
+// why this is worth stating: the day the reference table starts carrying one, its member
+// appears here by itself, because the derivation reads that table. `<adw-toggle>` already
+// made that move (ADR 0028 § Amendment, 2026-08-28) and needed no edit here.
+//
+// WHY A RE-EXPORT BARREL AND NOT AN OBJECT LITERAL. It was `export const Adw = { … }`
+// beside a merged `export namespace Adw { … }` of instance types, so that `Adw.HeaderBar`
+// could annotate as well as construct — every call site in this repository imports these
+// classes with `import type`. `tsc` accepts that merge; ROLLDOWN'S oxc PARSER DOES NOT,
+// and it fails at PARSE time — `Identifier \`Adw\` has already been declared`, a
+// PARSE_ERROR out of `Bundler::generate` that took every showcase importing this package
+// with it while `gjsify tsc` stayed green. The two check different things and the bundler
+// is the stricter one. An `export { X as Y } from` line needs no merge and no TypeScript
+// construct at all: a module namespace carries the value AND the type meaning of every
+// name in it, so `new Adw.HeaderBar()` and `as Adw.HeaderBar` both work off ONE list.
+// A second list of instance types could drift from the first; this one cannot exist.
+//
+// WHAT HOLDS IT: the namespace half of `scripts/check-vocabulary-alignment.mjs`. It
+// derives the members from the elements `customElements.define` registers and the
+// alignment table, and compares in both directions — an element with no member fails, a
+// member with no element fails, and a member bound to a class that is not that element's
+// fails. `namespaceExport` in `scripts/adwaita-elements.mjs` follows the one hop from
+// `src/index.ts` to this file and reads the LEFT side of each `as` as the binding.
+
+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 { AdwAvatar as Avatar } from '../elements/adw-avatar.js';
+export { AdwBanner as Banner } from '../elements/adw-banner.js';
+export { AdwBottomSheet as BottomSheet } from '../elements/adw-bottom-sheet.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 { 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 { 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';
+export { AdwOverlaySplitView as OverlaySplitView } from '../elements/adw-overlay-split-view.js';
+export { AdwPasswordEntryRow as PasswordEntryRow } from '../elements/adw-password-entry-row.js';
+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 { AdwShortcutLabel as ShortcutLabel } from '../elements/adw-shortcut-label.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 { 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';
+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 { 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';
+export { AdwWrapBox as WrapBox } from '../elements/adw-wrap-box.js';

package/src/namespace/gtk.ts

@@ -0,0 +1,22 @@
+// The GTK half of `@gjsify/adwaita-web`'s vocabulary — `Gtk.Entry`, `Gtk.Button`, one
+// member per element that `WEB_ELEMENT_ALIGNMENT` declares an alias of a `gtk-*` tag.
+// `export * as Gtk from './namespace/gtk.js'` in `src/index.ts` makes it the namespace.
+//
+// The derivation, the reason these are NOT `Adw.*`, why the `webOnly` elements have no
+// member, and why this is a re-export barrel rather than an object literal are all in
+// `./adw.ts`. One statement of it, because a second copy is the one that drifts.
+//
+// `Gtk.CheckButton` IS `GtkCheckButton`, NOT `AdwRadio` — the one GIR name two elements
+// declare. GTK4 has no radio type: a radio is a GtkCheckButton with its `group` set,
+// which is what `<adw-radio>`'s own `why` in the ledger says. So the plain form takes the
+// GIR name and the grouped one keeps its flat export in `src/index.ts`.
+
+export { GtkButton as Button } from '../elements/gtk-button.js';
+export { GtkCheckButton as CheckButton } from '../elements/checks.js';
+export { GtkDropDown as DropDown } from '../elements/gtk-drop-down.js';
+export { GtkEntry as Entry } from '../elements/gtk-entry.js';
+export { GtkImage as Image } from '../elements/gtk-image.js';
+export { GtkMenuButton as MenuButton } from '../elements/gtk-menu-button.js';
+export { GtkPopover as Popover } from '../elements/gtk-popover.js';
+export { GtkProgressBar as ProgressBar } from '../elements/gtk-progress-bar.js';
+export { GtkSwitch as Switch } from '../elements/gtk-switch.js';

package/src/preferences-search.ts

@@ -41,7 +41,7 @@ const ACTION_ROW_TAGS: ReadonlySet<string> = new Set([
 /**
  * `ADW_IS_PREFERENCES_ROW` for the browser elements — the first clause of
  * `row_has_title`. Spelled out rather than inferred from the `adw-` prefix, because a
- * group's boxed list legitimately holds other things: a bare `<adw-button>` dropped in as
+ * group's boxed list legitimately holds other things: a bare `<gtk-button>` dropped in as
  * a footer is not a preferences row and must not be searchable.
  */
 const PREFERENCES_ROW_TAGS: ReadonlySet<string> = new Set([

package/src/slotted-children.spec.ts

@@ -16,6 +16,9 @@
 import { describe, expect, it } from '@gjsify/unit';
 
 import * as adwaitaWeb from './index.js';
+// See `exported-elements.ts`: the widget classes live inside the exported `Adw`/`Gtk`
+// objects, so a top-level `Object.values` finds only the web-only stragglers.
+import { exportedElementClasses } from './exported-elements.js';
 import { bindSlottedChildren, slottedChildrenOf } from './slotted-children.js';
 
 /** One microtask checkpoint — where a MutationObserver callback lands. */
@@ -164,9 +167,8 @@ export const AdwSlottedChildrenTest = async () => {
     // declared child and an appended one in the same place.
     await describe('every slotted element adopts a late child where it adopts a declared one', async () => {
         const tags: string[] = [];
-        for (const exported of Object.values(adwaitaWeb)) {
-            if (typeof exported !== 'function' || !(exported.prototype instanceof HTMLElement)) continue;
-            const tag = customElements.getName(exported as CustomElementConstructor);
+        for (const exported of exportedElementClasses(adwaitaWeb)) {
+            const tag = customElements.getName(exported);
             if (tag !== null) tags.push(tag);
         }
         tags.sort();

package/src/source-view/adw-source-view.ts

@@ -34,7 +34,7 @@ import { defaultKeymap, history, historyKeymap } from '@codemirror/commands';
 import { asm6502 } from './asm6502.js';
 import { adwaitaEditorTheme, adwaitaHighlightStyle, ensureSourceViewStyleInjected } from './theme.js';
 import { formatHexAddress, formatLineNumber, stripWhitespace } from './hex.js';
-import { createAdwIcon } from '../elements/adw-icon.js';
+import { createGtkImage } from '../elements/gtk-image.js';
 
 /** A recognisable copy glyph rendered inline so the subpath needs no icon CSS. */
 const COPY_SVG =
@@ -405,7 +405,7 @@ export class AdwSourceView extends HTMLElement {
         }
         // A non-default icon uses the adwaita-web mask class (requires the main
         // bundle's icon CSS to be present).
-        this._copyButton.replaceChildren(createAdwIcon(name));
+        this._copyButton.replaceChildren(createGtkImage(name));
     }
 
     private _readDeclarativeAttributes(): void {

package/src/split-button.spec.ts

@@ -328,8 +328,8 @@ export const AdwSplitButtonTest = async () => {
 
     // The two behaviours a hand-rolled popover with only an outside-click handler cannot
     // give: leaving by keyboard, and reaching the items with the arrow keys. Both come
-    // from `<adw-popover>`, and these cases prove the lift was a lift, not a move.
-    await describe('adw-split-button menu keyboard (gained with <adw-popover>)', async () => {
+    // from `<gtk-popover>`, and these cases prove the lift was a lift, not a move.
+    await describe('adw-split-button menu keyboard (gained with <gtk-popover>)', async () => {
         await it('Escape dismisses the menu and returns focus to the dropdown half', () => {
             const { el, host } = mount({ menu: '[{"label":"Print"},{"label":"Export"}]' });
             dropdownHalf(el).click();
@@ -370,7 +370,7 @@ export const AdwSplitButtonTest = async () => {
             // Opening focuses the first row — without that there is nothing to move from.
             expect(document.activeElement).toBe(items[0]);
 
-            const menu = el.querySelector('adw-popover') as HTMLElement;
+            const menu = el.querySelector('gtk-popover') as HTMLElement;
             const press = (key: string) => menu.dispatchEvent(new KeyboardEvent('keydown', { key, bubbles: true }));
 
             press('ArrowDown');
@@ -396,7 +396,7 @@ export const AdwSplitButtonTest = async () => {
             el.addEventListener('menu-activated', (event) => seen.push((event as CustomEvent).detail.index));
 
             dropdownHalf(el).click();
-            const menu = el.querySelector('adw-popover') as HTMLElement;
+            const menu = el.querySelector('gtk-popover') as HTMLElement;
             menu.dispatchEvent(new KeyboardEvent('keydown', { key: 'ArrowDown', bubbles: true }));
             menu.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }));
 
@@ -425,7 +425,7 @@ export const AdwSplitButtonTest = async () => {
         await it(`draws a ${menuVector?.borderRadius}px surface with ${menuVector?.padding}px padding and a THREE-layer shadow`, () => {
             const { el, host } = mount({ menu: '[{"label":"Print"}]' });
             dropdownHalf(el).click();
-            const surface = el.querySelector('adw-popover') as HTMLElement;
+            const surface = el.querySelector('gtk-popover') as HTMLElement;
             const style = getComputedStyle(surface);
 
             expect(style.paddingTop).toBe(`${menuVector?.padding}px`);