@gjsify/adwaita-web 0.41.0 → 0.42.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-web",
-    "version": "0.41.0",
+    "version": "0.42.0",
     "description": "Adwaita/Libadwaita web components for browser targets",
     "type": "module",
     "main": "./src/index.ts",
@@ -14,6 +14,10 @@
             "types": "./lib/types/source-view/index.d.ts",
             "default": "./src/source-view/index.ts"
         },
+        "./fonts": {
+            "types": "./lib/types/fonts.d.ts",
+            "default": "./src/fonts.ts"
+        },
         "./style.css": {
             "types": "./style.css.d.ts",
             "default": "./dist/adwaita-web.css"
@@ -41,14 +45,14 @@
         "@codemirror/language": "^6.12.4",
         "@codemirror/state": "^6.7.0",
         "@codemirror/view": "^6.43.4",
-        "@gjsify/adwaita-core": "^0.41.0",
-        "@gjsify/adwaita-fonts": "^0.41.0",
-        "@gjsify/adwaita-icons": "^0.41.0",
+        "@gjsify/adwaita-core": "^0.42.0",
+        "@gjsify/adwaita-fonts": "^0.42.0",
+        "@gjsify/adwaita-icons": "^0.42.0",
         "@lezer/highlight": "^1.2.3"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.41.0",
-        "@gjsify/unit": "^0.41.0",
+        "@gjsify/cli": "^0.42.0",
+        "@gjsify/unit": "^0.42.0",
         "sass": "^1.101.0",
         "typescript": "^6.0.3"
     },

package/scss/_banner.scss

@@ -1,6 +1,6 @@
 // _banner.scss — adw-banner styling (full-width accent message strip).
 // Reference: refs/adwaita-web/adwaita-web/scss/_banner.scss
-// Reference: refs/libadwaita/src/stylesheet/widgets/_banner.scss
+// Reference: refs/libadwaita/src/stylesheet/widgets/_toolbars.scss (AdwBanner)
 // Copyright (c) GNOME contributors (libadwaita). LGPLv2.1+.
 // Modifications: Adapted for @gjsify/adwaita-web Web Components.
 

package/scss/_checks.scss

@@ -1,13 +1,13 @@
 // _checks.scss — <adw-checkbox> AND <adw-radio>, in ONE partial.
 //
-// WHY ONE FILE FOR TWO ELEMENTS. `refs/libadwaita/src/stylesheet/widgets/
-// _checks.scss` merges them deliberately: everything but the corner radius and
-// the glyph is a shared `check, radio { … }` block (:20-65), and the
-// indeterminate dash is re-declared for BOTH at the end (:79-81). There is no
-// `_radio.scss` upstream to mirror. `refs/adwaita-web` does split them into
-// `_checkbox.scss` + `_radio.scss`, and the split is exactly where it drifted:
-// its two indicators grew different sizes, different border treatments and
-// different selection-mode rules, and only one of them has a hover state.
+// WHY ONE FILE FOR TWO ELEMENTS. Upstream's
+// `refs/libadwaita/src/stylesheet/widgets/_checks.scss` merges them deliberately:
+// everything but the corner radius and the glyph is a shared `check, radio { … }`
+// block (:20-65), and the indeterminate dash is re-declared for BOTH at the end
+// (:79-81). There is no `_radio.scss` upstream to mirror. `refs/adwaita-web` does
+// split them into `_checkbox.scss` + `_radio.scss`, and the split is exactly where
+// it drifted: its two indicators grew different sizes, different border treatments
+// and different selection-mode rules, and only one of them has a hover state.
 //
 // TWO PLACES THE VENDORED WEB PORT DISAGREES WITH LIBADWAITA. libadwaita is
 // followed in both:

package/scss/_combo_row.scss

@@ -1,6 +1,6 @@
 // _combo_row.scss — adw-combo-row styling.
 // Reference: refs/adwaita-web/adwaita-web/scss/_combo_row.scss
-// Reference: refs/libadwaita/src/stylesheet/widgets/_combo-row.scss
+// Reference: refs/libadwaita/src/stylesheet/widgets/_lists.scss (AdwComboRow)
 // Copyright (c) GNOME contributors (libadwaita). LGPLv2.1+.
 // Copyright (c) 2025 csm (adwaita-web). MIT License.
 // Modifications: Adapted for @gjsify/adwaita-web Web Components.

package/scss/_drop_down.scss

@@ -5,7 +5,7 @@
 // (soft triple shadow), the items its modelbutton rows, matching <adw-menu-button>.
 // Reference: refs/libadwaita/src/stylesheet/widgets/_popovers.scss (popover > contents)
 // Reference: refs/libadwaita/src/stylesheet/widgets/_menus.scss (modelbutton rows)
-// Reference: refs/libadwaita/src/stylesheet/widgets/_drop-down.scss (dropdown button)
+// Reference: refs/libadwaita/src/stylesheet/widgets/_dropdowns.scss (dropdown button)
 // Copyright (c) GNOME contributors (libadwaita). LGPLv2.1+.
 // Modifications: Implemented for @gjsify/adwaita-web Web Components.
 

package/scss/_expander_row.scss

@@ -1,6 +1,6 @@
 // _expander_row.scss — adw-expander-row styling (disclosure header + nested rows).
 // Reference: refs/adwaita-web/adwaita-web/scss/_expander_row.scss
-// Reference: refs/libadwaita/src/stylesheet/widgets/_expander-row.scss
+// Reference: refs/libadwaita/src/stylesheet/widgets/_lists.scss (AdwExpanderRow)
 // Copyright (c) GNOME contributors (libadwaita). LGPLv2.1+.
 // Copyright (c) 2025 csm (adwaita-web). MIT License.
 // Modifications: Adapted for @gjsify/adwaita-web Web Components.

package/scss/_icon.scss

@@ -49,3 +49,50 @@
     display: none;
   }
 }
+
+// THE FALLBACK GLYPH — what a name the stylesheet cannot draw resolves to.
+//
+// Until this rule existed there was no `mask-image` on `.adw-icon` at all, so an
+// icon whose name has no generated class kept `background-color: currentColor`
+// over an empty mask and painted a SOLID 16px square in the widget's text
+// colour. Measured in Firefox: `.adw-icon.adw-icon--dialog-error` reported
+// `mask-image: none`, `background-color: rgb(0, 128, 0)`, box 16x16 — visually a
+// deliberate colour swatch, which is why three renderer-comparison surfaces
+// carried substituted glyphs and nobody read it as a bug.
+//
+// `image-missing` is libadwaita's OWN answer to "I have no icon to draw here":
+// C substitutes exactly that name for a NULL icon-name in three widgets
+// (adw-button-content.c:294,356 · adw-view-switcher-button.c:286,347,405 ·
+// adw-inline-view-switcher.c:142), and GTK's icon theme returns the same
+// broken-image paintable for a name it cannot find. So the three renderers end
+// up on ONE glyph: GTK draws it from the system theme, the web draws it from
+// here, and NativeScript cannot reach the state at all — its AdwIcon takes SVG
+// SOURCE, not a name, so a missing icon there is a missing import the compiler
+// rejects. Nothing THROWS, on any of the three: an icon is decorative and taking
+// an application down over a glyph is a failure mode none of them has.
+//
+// `:where()` and not `.adw-icon`, and that is the load-bearing detail:
+// `adwaita-skin.scss` @uses `icons.generated` BEFORE `icon`, so at equal
+// 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.
+:where(.adw-icon) {
+  mask-image: var(--icon-image-missing);
+  -webkit-mask-image: var(--icon-image-missing);
+}
+
+// …and NO name at all draws nothing, rather than the broken glyph. `<adw-icon>`
+// leaves the node classless only when `icon-name` is ABSENT or EMPTY, which is the
+// state where the HOST decided against an icon — the tab strip's indicator slot,
+// the avatar's fallback while initials show. `Gtk.Image` with a NULL icon-name
+// draws nothing too.
+//
+// A name that was GIVEN never reaches this rule, even an unusable one: the element
+// puts `adw-icon--image-missing` on it, because `gtk_icon_theme_lookup_icon` has no
+// "found nothing" answer either. Until it did, `<adw-button-row start-icon-name="a b">`
+// reserved a VISIBLE 16px slot and painted none of it — this rule turning the
+// pre-existing solid square into an invisible hole.
+.adw-icon:not([class*='adw-icon--']) {
+  background-color: transparent;
+}

package/scss/_icons.generated.scss

@@ -2,7 +2,6 @@
 // DO NOT EDIT — regenerated on every build from @gjsify/adwaita-icons.
 
 :root {
-  --icon-edit-paste: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%207%200%20c%20-0.554688%200%20-1%200.445312%20-1%201%20h%20-2%20c%20-1.644531%200%20-3%201.355469%20-3%203%20v%209%20c%200%201.644531%201.355469%203%203%203%20h%208%20c%201.644531%200%203%20-1.355469%203%20-3%20v%20-9%20c%200%20-1.644531%20-1.355469%20-3%20-3%20-3%20h%20-2%20c%200%20-0.554688%20-0.445312%20-1%20-1%20-1%20z%20m%20-3%203%20h%201%20v%201%20c%200%200.554688%200.445312%201%201%201%20h%204%20c%200.554688%200%201%20-0.445312%201%20-1%20v%20-1%20h%201%20c%200.570312%200%201%200.429688%201%201%20v%209%20c%200%200.570312%20-0.429688%201%20-1%201%20h%20-8%20c%20-0.570312%200%20-1%20-0.429688%20-1%20-1%20v%20-9%20c%200%20-0.570312%200.429688%20-1%201%20-1%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
   --icon-go-down: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%201%205%20c%200%20-0.265625%200.105469%20-0.519531%200.292969%20-0.707031%20c%200.390625%20-0.390625%201.023437%20-0.390625%201.414062%200%20l%205.292969%205.292969%20l%205.292969%20-5.292969%20c%200.390625%20-0.390625%201.023437%20-0.390625%201.414062%200%20c%200.1875%200.1875%200.292969%200.441406%200.292969%200.707031%20s%20-0.105469%200.519531%20-0.292969%200.707031%20l%20-6%206%20c%20-0.390625%200.390625%20-1.023437%200.390625%20-1.414062%200%20l%20-6%20-6%20c%20-0.1875%20-0.1875%20-0.292969%20-0.441406%20-0.292969%20-0.707031%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
   --icon-sidebar-show: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cg%20fill%3D'currentColor'%3E%20%3Cpath%20d%3D'm%206%2013%20v%20-10%20h%20-3%20c%20-0.550781%200%20-1%200.449219%20-1%201%20v%208%20c%200%200.550781%200.449219%201%201%201%20z%20m%200%200'%20fill-opacity%3D'0.34902'%2F%3E%20%3Cpath%20d%3D'm%203%201%20c%20-1.644531%200%20-3%201.355469%20-3%203%20v%208%20c%200%201.644531%201.355469%203%203%203%20h%2010%20c%201.644531%200%203%20-1.355469%203%20-3%20v%20-8%20c%200%20-1.644531%20-1.355469%20-3%20-3%20-3%20z%20m%200%202%20h%203%20v%2010%20h%20-3%20c%20-0.570312%200%20-1%20-0.429688%20-1%20-1%20v%20-8%20c%200%20-0.570312%200.429688%20-1%201%20-1%20z%20m%204%200%20h%206%20c%200.570312%200%201%200.429688%201%201%20v%208%20c%200%200.570312%20-0.429688%201%20-1%201%20h%20-6%20z%20m%200%200'%2F%3E%20%3C%2Fg%3E%20%3C%2Fsvg%3E");
   --icon-go-previous: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%2012%202%20c%200%20-0.265625%20-0.105469%20-0.519531%20-0.292969%20-0.707031%20c%20-0.390625%20-0.390625%20-1.023437%20-0.390625%20-1.414062%200%20l%20-6%206%20c%20-0.1875%200.1875%20-0.292969%200.441406%20-0.292969%200.707031%20s%200.105469%200.519531%200.292969%200.707031%20l%206%206%20c%200.390625%200.390625%201.023437%200.390625%201.414062%200%20c%200.1875%20-0.1875%200.292969%20-0.441406%200.292969%20-0.707031%20s%20-0.105469%20-0.519531%20-0.292969%20-0.707031%20l%20-5.292969%20-5.292969%20l%205.292969%20-5.292969%20c%200.1875%20-0.1875%200.292969%20-0.441406%200.292969%20-0.707031%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
@@ -27,9 +26,12 @@
   --icon-document-save: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%208%200%20c%20-0.550781%200%20-1%200.449219%20-1%201%20v%208.585938%20l%20-1.292969%20-1.292969%20c%20-0.1875%20-0.1875%20-0.441406%20-0.292969%20-0.707031%20-0.292969%20s%20-0.519531%200.105469%20-0.707031%200.292969%20c%20-0.390625%200.390625%20-0.390625%201.023437%200%201.414062%20l%203%203%20c%200.390625%200.390625%201.023437%200.390625%201.414062%200%20l%203%20-3%20c%200.390625%20-0.390625%200.390625%20-1.023437%200%20-1.414062%20s%20-1.023437%20-0.390625%20-1.414062%200%20l%20-1.292969%201.292969%20v%20-8.585938%20c%200%20-0.550781%20-0.449219%20-1%20-1%20-1%20z%20m%20-7%2014%20v%202%20h%2014%20v%20-2%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
   --icon-mail-send: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%208%200%20c%20-0.257812%200%20-0.511719%200.0976562%20-0.707031%200.292969%20l%20-1.25%201.25%20l%20-1.761719%201.730469%20c%20-0.191406%200.199218%20-0.28125%200.441406%20-0.28125%200.75%20c%200%200.976562%201%201%201%201%20c%200.257812%200%200.527344%20-0.128907%200.71875%20-0.3125%20l%201.28125%20-1.28125%20v%203.570312%20s%200%201%201%201%20s%201%20-1%201%20-1%20v%20-3.570312%20l%201.28125%201.28125%20c%200.191406%200.183593%200.410156%200.3125%200.71875%200.3125%20c%200%200%201%20-0.023438%201%20-1%20c%200%20-0.308594%20-0.089844%20-0.550782%20-0.28125%20-0.75%20l%20-1.761719%20-1.730469%20l%20-1.25%20-1.25%20c%20-0.195312%20-0.1953128%20-0.449219%20-0.292969%20-0.707031%20-0.292969%20z%20m%20-5%209%20c%20-1.644531%200%20-3%201.355469%20-3%203%20v%204%20h%202%20v%20-3.800781%20l%204.613281%203.078125%20c%200.835938%200.558594%201.9375%200.558594%202.773438%200%20l%204.613281%20-3.078125%20v%203.800781%20h%202%20v%20-4%20c%200%20-1.644531%20-1.355469%20-3%20-3%20-3%20z%20m%200.800781%202%20h%208.398438%20l%20-3.921875%202.613281%20c%20-0.171875%200.113281%20-0.382813%200.113281%20-0.554688%200%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
   --icon-mail-reply-sender: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%205%202%20c%20-0.265625%200%20-0.519531%200.105469%20-0.707031%200.292969%20l%20-4%204%20c%20-0.3906252%200.390625%20-0.3906252%201.023437%200%201.414062%20l%204%204%20c%200.390625%200.390625%201.023437%200.390625%201.414062%200%20s%200.390625%20-1.023437%200%20-1.414062%20l%20-2.292969%20-2.292969%20h%208.585938%20c%201.117188%200%202%200.882812%202%202%20v%203%20c%200%200.550781%200.449219%201%201%201%20s%201%20-0.449219%201%20-1%20v%20-3%20c%200%20-0.023438%200%20-0.046875%20-0.003906%20-0.070312%20c%20-0.035156%20-2.164063%20-1.820313%20-3.929688%20-3.996094%20-3.929688%20h%20-8.585938%20l%202.292969%20-2.292969%20c%200.390625%20-0.390625%200.390625%20-1.023437%200%20-1.414062%20c%20-0.1875%20-0.1875%20-0.441406%20-0.292969%20-0.707031%20-0.292969%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
+  --icon-folder-documents: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%204.96875%201.003906%20c%20-1.644531%200%20-3%201.355469%20-3%203%20v%209%20c%200%201.644532%201.355469%203%203%203%20h%206%20c%201.644531%200%203%20-1.355468%203%20-3%20v%20-7.5%20c%200%20-0.265625%20-0.105469%20-0.519531%20-0.292969%20-0.707031%20l%20-3.5%20-3.5%20c%20-0.1875%20-0.1875%20-0.441406%20-0.292969%20-0.707031%20-0.292969%20z%20m%200%202%20h%204%20v%201.5%20c%200%201%200.5%201.5%201.5%201.5%20h%201.5%20v%207%20c%200%200.570313%20-0.429688%201%20-1%201%20h%20-6%20c%20-0.570312%200%20-1%20-0.429687%20-1%20-1%20v%20-9%20c%200%20-0.570312%200.429688%20-1%201%20-1%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
   --icon-folder-download: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%207.984375%200%20c%20-0.550781%200%20-1%200.449219%20-1%201%20v%208.585938%20l%20-2.292969%20-2.292969%20c%20-0.1875%20-0.1875%20-0.441406%20-0.292969%20-0.707031%20-0.292969%20s%20-0.519531%200.105469%20-0.707031%200.292969%20c%20-0.390625%200.390625%20-0.390625%201.023437%200%201.414062%20l%204%204%20c%200.390625%200.390625%201.023437%200.390625%201.414062%200%20l%204%20-4%20c%200.390625%20-0.390625%200.390625%20-1.023437%200%20-1.414062%20s%20-1.023437%20-0.390625%20-1.414062%200%20l%20-2.292969%202.292969%20v%20-8.585938%20c%200%20-0.550781%20-0.449219%20-1%20-1%20-1%20z%20m%20-6%2014%20v%202%20h%2012%20v%20-2%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
   --icon-view-grid: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%202%201%20c%20-0.554688%200%20-1%200.445312%20-1%201%20v%204%20c%200%200.554688%200.445312%201%201%201%20h%204%20c%200.554688%200%201%20-0.445312%201%20-1%20v%20-4%20c%200%20-0.554688%20-0.445312%20-1%20-1%20-1%20z%20m%208%200%20c%20-0.554688%200%20-1%200.445312%20-1%201%20v%204%20c%200%200.554688%200.445312%201%201%201%20h%204%20c%200.554688%200%201%20-0.445312%201%20-1%20v%20-4%20c%200%20-0.554688%20-0.445312%20-1%20-1%20-1%20z%20m%20-8%208%20c%20-0.554688%200%20-1%200.445312%20-1%201%20v%204%20c%200%200.554688%200.445312%201%201%201%20h%204%20c%200.554688%200%201%20-0.445312%201%20-1%20v%20-4%20c%200%20-0.554688%20-0.445312%20-1%20-1%20-1%20z%20m%208%200%20c%20-0.554688%200%20-1%200.445312%20-1%201%20v%204%20c%200%200.554688%200.445312%201%201%201%20h%204%20c%200.554688%200%201%20-0.445312%201%20-1%20v%20-4%20c%200%20-0.554688%20-0.445312%20-1%20-1%20-1%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
   --icon-view-list: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%202%201%20c%20-0.554688%200%20-1%200.445312%20-1%201%20v%202%20c%200%200.554688%200.445312%201%201%201%20h%202%20c%200.554688%200%201%20-0.445312%201%20-1%20v%20-2%20c%200%20-0.554688%20-0.445312%20-1%20-1%20-1%20z%20m%205%201%20v%202%20h%208%20v%20-2%20z%20m%20-5%204.015625%20c%20-0.554688%200%20-1%200.445313%20-1%201%20v%201.980469%20c%200%200.550781%200.445312%201%201%201%20h%202%20c%200.554688%200%201%20-0.449219%201%20-1%20v%20-1.980469%20c%200%20-0.554687%20-0.445312%20-1%20-1%20-1%20z%20m%205%200.984375%20v%202%20h%208%20v%20-2%20z%20m%20-5%204%20c%20-0.554688%200%20-1%200.445312%20-1%201%20v%201.980469%20c%200%200.550781%200.445312%201%201%201%20h%202%20c%200.554688%200%201%20-0.449219%201%20-1%20v%20-1.980469%20c%200%20-0.554688%20-0.445312%20-1%20-1%20-1%20z%20m%205%200.984375%20v%202%20h%208%20v%20-2%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
+  --icon-view-more: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%207.996094%200%20c%20-1.105469%200%20-2%200.894531%20-2%202%20s%200.894531%202%202%202%20c%201.101562%200%202%20-0.894531%202%20-2%20s%20-0.898438%20-2%20-2%20-2%20z%20m%200%206%20c%20-1.105469%200%20-2%200.894531%20-2%202%20s%200.894531%202%202%202%20c%201.101562%200%202%20-0.894531%202%20-2%20s%20-0.898438%20-2%20-2%20-2%20z%20m%200%206%20c%20-1.105469%200%20-2%200.894531%20-2%202%20s%200.894531%202%202%202%20c%201.101562%200%202%20-0.894531%202%20-2%20s%20-0.898438%20-2%20-2%20-2%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
+  --icon-view-paged: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cg%20fill%3D'currentColor'%3E%20%3Cpath%20d%3D'm%209%205.5%20v%20-1%20c%200%20-0.277344%20-0.222656%20-0.5%20-0.5%20-0.5%20h%20-3%20c%20-0.277344%200%20-0.5%200.222656%20-0.5%200.5%20v%201%20c%200%200.277344%200.222656%200.5%200.5%200.5%20h%203%20c%200.277344%200%200.5%20-0.222656%200.5%20-0.5%20z%20m%200%200'%20fill-opacity%3D'0.34902'%2F%3E%20%3Cpath%20d%3D'm%204%200%20c%20-1.644531%200%20-3%201.355469%20-3%203%20v%207%20c%200%201.644531%201.355469%203%203%203%20h%206%20c%201.644531%200%203%20-1.355469%203%20-3%20v%20-7%20c%200%20-1.644531%20-1.355469%20-3%20-3%20-3%20z%20m%200%202%20h%206%20c%200.570312%200%201%200.429688%201%201%20v%207%20c%200%200.570312%20-0.429688%201%20-1%201%20h%20-6%20c%20-0.570312%200%20-1%20-0.429688%20-1%20-1%20v%20-7%20c%200%20-0.570312%200.429688%20-1%201%20-1%20z%20m%2011%202%20c%20-0.550781%200%20-1%200.449219%20-1%201%20v%208%20c%200%200.550781%20-0.449219%201%20-1%201%20h%20-7%20c%20-0.550781%200%20-1%200.449219%20-1%201%20s%200.449219%201%201%201%20h%207%20c%201.65625%200%203%20-1.34375%203%20-3%20v%20-8%20c%200%20-0.550781%20-0.449219%20-1%20-1%20-1%20z%20m%200%200'%2F%3E%20%3Cpath%20d%3D'm%209%208.5%20v%20-1%20c%200%20-0.277344%20-0.222656%20-0.5%20-0.5%20-0.5%20h%20-3%20c%20-0.277344%200%20-0.5%200.222656%20-0.5%200.5%20v%201%20c%200%200.277344%200.222656%200.5%200.5%200.5%20h%203%20c%200.277344%200%200.5%20-0.222656%200.5%20-0.5%20z%20m%200%200'%20fill-opacity%3D'0.34902'%2F%3E%20%3C%2Fg%3E%20%3C%2Fsvg%3E");
   --icon-view-columns: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%202%201%20c%20-0.554688%200%20-1%200.445312%20-1%201%20v%2012%20c%200%200.554688%200.445312%201%201%201%20h%202%20c%200.554688%200%201%20-0.445312%201%20-1%20v%20-12%20c%200%20-0.554688%20-0.445312%20-1%20-1%20-1%20z%20m%205%200%20c%20-0.554688%200%20-1%200.445312%20-1%201%20v%2012%20c%200%200.554688%200.445312%201%201%201%20h%202%20c%200.554688%200%201%20-0.445312%201%20-1%20v%20-12%20c%200%20-0.554688%20-0.445312%20-1%20-1%20-1%20z%20m%205%200%20c%20-0.554688%200%20-1%200.445312%20-1%201%20v%2012%20c%200%200.554688%200.445312%201%201%201%20h%202%20c%200.554688%200%201%20-0.445312%201%20-1%20v%20-12%20c%200%20-0.554688%20-0.445312%20-1%20-1%20-1%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
   --icon-list-remove: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%201%207%20h%2014%20v%202%20h%20-14%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
   --icon-send-to: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%208%200%20c%20-0.257812%200%20-0.511719%200.0976562%20-0.707031%200.292969%20l%20-1.246094%201.25%20l%20-1.765625%201.730469%20c%20-0.191406%200.199218%20-0.28125%200.441406%20-0.28125%200.75%20c%200%200.976562%201%201%201%201%20c%200.257812%200%200.527344%20-0.128907%200.71875%20-0.3125%20l%201.28125%20-1.28125%20v%207.570312%20s%200%201%201%201%20s%201%20-1%201%20-1%20v%20-7.570312%20l%201.28125%201.28125%20c%200.191406%200.183593%200.410156%200.3125%200.71875%200.3125%20c%200%200%201%20-0.023438%201%20-1%20c%200%20-0.308594%20-0.089844%20-0.550782%20-0.28125%20-0.75%20l%20-1.765625%20-1.730469%20l%20-1.246094%20-1.25%20c%20-0.195312%20-0.1953128%20-0.449219%20-0.292969%20-0.707031%20-0.292969%20z%20m%20-3.96875%206.964844%20c%20-1.660156%20-0.027344%20-3.03125%201.371094%20-3.03125%203.035156%20v%202.972656%20c%200%201.664063%201.371094%203.035156%203.03125%203.035156%20h%207.9375%20c%201.664062%200%203.03125%20-1.371093%203.03125%20-3.035156%20v%20-2.972656%20c%200%20-1.664062%20-1.367188%20-3.0625%20-3.03125%20-3.035156%20l%20-1.96875%200.035156%20v%202%20l%201.96875%20-0.035156%20c%200.589844%20-0.007813%201.03125%200.445312%201.03125%201.035156%20v%202.972656%20c%200%200.589844%20-0.441406%201.035156%20-1.03125%201.035156%20h%20-7.9375%20c%20-0.585938%200%20-1.03125%20-0.445312%20-1.03125%20-1.035156%20v%20-2.972656%20c%200%20-0.589844%200.445312%20-1.042969%201.03125%20-1.035156%20l%201.96875%200.035156%20v%20-2%20z%20m%200%200'%20fill%3D'currentColor'%2F%3E%20%3C%2Fsvg%3E");
@@ -44,11 +46,6 @@
   --icon-image-missing: url("data:image/svg+xml,%3Csvg%20height%3D'16px'%20viewBox%3D'0%200%2016%2016'%20width%3D'16px'%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%3E%20%3Cpath%20d%3D'm%204.015625%201.03125%20c%20-1.644531%200%20-3%201.355469%20-3%203%20v%201%20h%201%20v%20-1%20c%200%20-1.109375%200.890625%20-2%202%20-2%20h%201%20v%20-1%20z%20m%202%200%20v%201%20h%204%20v%20-1%20z%20m%205%200%20v%201%20h%201%20c%201.109375%200%202%200.890625%202%202%20v%201%20h%201%20v%20-1%20c%200%20-1.644531%20-1.355469%20-3%20-3%20-3%20z%20m%20-5%204%20c%20-0.550781%200%20-1%200.449219%20-1%201%20s%200.449219%201%201%201%20s%201%20-0.449219%201%20-1%20s%20-0.449219%20-1%20-1%20-1%20z%20m%20-5%201%20v%204%20h%201%20v%20-4%20z%20m%2013%200%20v%204%20h%201%20v%20-4%20z%20m%20-4.5%202%20l%20-2%202%20l%20-1.5%20-1%20l%20-2%202%20v%200.5%20c%200%200.5%200.5%200.5%200.5%200.5%20h%207%20s%200.472656%20-0.035156%200.5%20-0.5%20v%20-1%20z%20m%20-8.5%203%20v%201%20c%200%201.644531%201.355469%203%203%203%20h%201%20v%20-1%20h%20-1%20c%20-1.109375%200%20-2%20-0.890625%20-2%20-2%20v%20-1%20z%20m%2013%200%20v%201%20c%200%201.109375%20-0.890625%202%20-2%202%20h%20-1%20v%201%20h%201%20c%201.644531%200%203%20-1.355469%203%20-3%20v%20-1%20z%20m%20-8%203%20v%201%20h%204%20v%20-1%20z%20m%200%200'%20fill%3D'currentColor'%20fill-opacity%3D'0.34902'%2F%3E%20%3C%2Fsvg%3E");
 }
 
-.adw-icon--edit-paste {
-  mask-image: var(--icon-edit-paste);
-  -webkit-mask-image: var(--icon-edit-paste);
-}
-
 .adw-icon--go-down {
   mask-image: var(--icon-go-down);
   -webkit-mask-image: var(--icon-go-down);
@@ -169,6 +166,11 @@
   -webkit-mask-image: var(--icon-mail-reply-sender);
 }
 
+.adw-icon--folder-documents {
+  mask-image: var(--icon-folder-documents);
+  -webkit-mask-image: var(--icon-folder-documents);
+}
+
 .adw-icon--folder-download {
   mask-image: var(--icon-folder-download);
   -webkit-mask-image: var(--icon-folder-download);
@@ -184,6 +186,16 @@
   -webkit-mask-image: var(--icon-view-list);
 }
 
+.adw-icon--view-more {
+  mask-image: var(--icon-view-more);
+  -webkit-mask-image: var(--icon-view-more);
+}
+
+.adw-icon--view-paged {
+  mask-image: var(--icon-view-paged);
+  -webkit-mask-image: var(--icon-view-paged);
+}
+
 .adw-icon--view-columns {
   mask-image: var(--icon-view-columns);
   -webkit-mask-image: var(--icon-view-columns);

package/scss/_password_entry_row.scss

@@ -1,7 +1,7 @@
 // _password_entry_row.scss — adw-password-entry-row styling (masked entry row
 // with a trailing peek toggle). Mirrors _entry_row.scss (the password row is a
 // specialization of the entry row) and adds the flat peek button.
-// Reference: refs/adwaita-web/adwaita-web/scss/_password_entry_row.scss
+// Reference: refs/adwaita-web/adwaita-web/scss/_entry_row.scss (no password variant upstream)
 // Reference: refs/libadwaita/src/adw-password-entry-row.c
 // Copyright (c) GNOME contributors (libadwaita). LGPLv2.1+.
 // Copyright (c) 2025 csm (adwaita-web). MIT License.

package/scss/_preferences_dialog.scss

@@ -83,8 +83,9 @@ adw-preferences-dialog {
     padding: 0 6px;
   }
 
-  // Round flat close button drawing a CSS "×" glyph (no symbolic close icon
-  // ships in @gjsify/adwaita-icons — same approach as <adw-tab-view>).
+  // Round flat close button drawing a CSS "×" glyph — same approach as
+  // <adw-tab-view>, and for the sizing reason recorded there. `windowCloseSymbolic`
+  // does ship, and is compiled.
   .adw-preferences-dialog-close {
     appearance: none;
     border: none;

package/scss/_progress_bar.scss

@@ -29,7 +29,7 @@
 // rule that rots.
 //
 // Reference: refs/libadwaita/src/stylesheet/widgets/_progress-bar.scss:5-6,17-21,23-25,27-35,59-85
-// Reference: refs/libadwaita/src/stylesheet/_scale.scss:1-17 (%scale_trough, %scale_highlight)
+// Reference: refs/libadwaita/src/stylesheet/widgets/_scale.scss:1-17 (%scale_trough, %scale_highlight)
 // Reference: refs/libadwaita/src/stylesheet/_colors.scss:280-286 (the trough colours)
 // Reference: refs/adwaita-web/adwaita-web/scss/_progressbar.scss:25-66 (indeterminate keyframes + reduced-motion fallback ONLY)
 // Copyright (c) GNOME contributors (libadwaita). LGPLv2.1+.

package/scss/_row.scss

@@ -1,6 +1,6 @@
 // _row.scss — Shared base styling for rows in preferences groups.
 // Reference: refs/adwaita-web/adwaita-web/scss/_row_types.scss
-// Reference: refs/libadwaita/src/stylesheet/widgets/_action-row.scss
+// Reference: refs/libadwaita/src/stylesheet/widgets/_lists.scss (AdwActionRow)
 // Copyright (c) GNOME contributors (libadwaita). LGPLv2.1+.
 // Copyright (c) 2025 csm (adwaita-web). MIT License.
 // Modifications: Adapted for @gjsify/adwaita-web Web Components.

package/scss/_status_page.scss

@@ -1,6 +1,6 @@
 // _status_page.scss — adw-status-page styling (centered empty state).
 // Reference: refs/adwaita-web/adwaita-web/scss/_status_page.scss
-// Reference: refs/libadwaita/src/stylesheet/widgets/_status-page.scss
+// Reference: refs/libadwaita/src/stylesheet/widgets/_misc.scss (AdwStatusPage)
 // Copyright (c) GNOME contributors (libadwaita). LGPLv2.1+.
 // Modifications: Adapted for @gjsify/adwaita-web Web Components.
 

package/scss/_tab_view.scss

@@ -183,7 +183,7 @@ adw-tab-view {
     background-color: var(--accent-bg-color);
   }
 
-  // --- Close affordance (CSS-drawn "×", no symbolic icon ships) ---
+  // --- Close affordance (CSS-drawn "×"; `window-close` ships, see adw-tab-view.ts) ---
   // Presence is decided in JS by `tabCloseVisible` — `(hovering && fullyVisible)
   // || selected || dragging`, and never on a pinned tab (adw-tab.c:124, :645-650)
   // — which is why the `[hidden]` rule below is load-bearing rather than cosmetic.

package/scss/_toast.scss

@@ -5,7 +5,7 @@
 // up on show / down on dismiss (mirroring Adw.Toast).
 // Reference: refs/adwaita-web/adwaita-web/scss/_toast.scss
 // Reference: refs/adwaita-web/adwaita-web/scss/_toast_overlay.scss
-// Reference: refs/libadwaita/src/stylesheet/widgets/_toast.scss
+// Reference: refs/libadwaita/src/stylesheet/widgets/_misc.scss (Toasts)
 // Copyright (c) GNOME contributors (libadwaita). LGPLv2.1+.
 // Copyright (c) 2025 csm (adwaita-web). MIT License.
 // Modifications: Adapted for @gjsify/adwaita-web Web Components.
@@ -120,12 +120,14 @@ adw-toast-overlay {
     }
   }
 
-  // Close affordance — a CSS-drawn "×" (mirrors adw-tab-view's .adw-tab-close;
-  // no symbolic close icon ships in the curated adwaita-web icon set).
+  // Close affordance — `window-close-symbolic` in a 24px circle, as upstream builds it
+  // (adw-toast-widget.ui:64). The element supplies the <adw-icon>; this only places it.
   .adw-toast-close-button {
     box-sizing: border-box;
     flex-shrink: 0;
-    position: relative;
+    display: flex;
+    align-items: center;
+    justify-content: center;
     width: 24px;
     height: 24px;
     margin: 0;
@@ -149,25 +151,5 @@ adw-toast-overlay {
       outline: 2px solid var(--accent-color);
       outline-offset: 1px;
     }
-
-    &::before,
-    &::after {
-      content: '';
-      position: absolute;
-      top: 50%;
-      left: 50%;
-      width: 11px;
-      height: 1.5px;
-      background-color: currentColor;
-      border-radius: 1px;
-    }
-
-    &::before {
-      transform: translate(-50%, -50%) rotate(45deg);
-    }
-
-    &::after {
-      transform: translate(-50%, -50%) rotate(-45deg);
-    }
   }
 }

package/scss/_variables.scss

@@ -144,9 +144,29 @@
   // by AdwStyleManager from the desktop's font settings
   // (adw-style-manager.c:169-218), defaulting to `Sans 10` / `Monospace 10`
   // (:50-56). A browser has no style manager, so they are ordinary tokens here
-  // — same names, so re-theming goes through the documented contract. The
-  // monospace stack is the one `_data_grid.scss` used to inline; it has ONE home
-  // now, and Adwaita Mono heads it because `@gjsify/adwaita-fonts` ships it.
+  // — same names, so re-theming goes through the documented contract.
+  //
+  // The monospace stack has ONE home, and did not until recently: `_data_grid.scss`
+  // used to inline it, and `source-view/theme.ts` carried a SECOND, longer copy in
+  // a TS string literal (measured on one page, `.cm-scroller` resolved to
+  // 'Adwaita Mono', 'Cascadia Code', 'JetBrains Mono', … while a `.monospace`
+  // label beside it resolved to this token — two typefaces, same document).
+  // A literal in TS is also outside the `stylesheet-font-families` rule, which
+  // reads `.css`/`.scss`. Both now read this token; its consumers are
+  // `.monospace` (_labels.scss:128), `_action_row.scss:94`, the data-grid mono
+  // cell (via `@extend .monospace`) and `<adw-source-view>`.
+  //
+  // Adwaita Mono heads the stack as a PROGRESSIVE ENHANCEMENT, not because
+  // anything here ships it: `@gjsify/adwaita-fonts` vendors two Sans TTFs and no
+  // mono face at all (the upstream mono faces are 1.4-1.5 MB each). This comment
+  // used to claim the package ships it — a claim the NativeScript theme, which
+  // carries the same stack, already contradicted in prose
+  // (`nativescript-bridge/adwaita/src/theme/adwaita.css:769`). So on a GNOME
+  // desktop the system `adwaita-mono-fonts` resolves it; anywhere else the
+  // generic tail is what renders, which is the correct outcome and the reason the
+  // tail exists. Held honest by the `stylesheet-font-families` conformance rule,
+  // whose ledger carries this reason — never delete one without the other.
+  //
   // `'Cantarell'` is dropped from that stack on the way here: Cantarell is
   // GNOME's PROPORTIONAL UI font, so a monospace fallback chain that reaches it
   // second lands on a font whose figures do not line up — the exact property

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

@@ -26,6 +26,9 @@ import {
 
 import { normalizeIconName } from '@gjsify/adwaita-core';
 
+import { isIconAvailable } from './icon-registry.js';
+import { fallbackMask, maskOf } from './icon-registry.spec.js';
+
 import type { AdwActionRow } from './elements/adw-action-row.js';
 import type { AdwSwitchRow } from './elements/adw-switch-row.js';
 import type { AdwWindowTitle } from './elements/adw-window-title.js';
@@ -259,15 +262,24 @@ export const AdwActionRowsTest = async () => {
                 // The mask class is the NORMALIZED name — the generated classes never
                 // carry `-symbolic`, so interpolating the raw one asks for a class that has
                 // never existed and draws an empty box.
-                if (vector.startIconVisible) {
-                    expect(icons[0]!.classList.contains(`adw-icon--${normalizeIconName(vector.startIconName)}`)).toBe(
-                        true,
-                    );
-                }
-                if (vector.endIconVisible) {
-                    expect(icons[1]!.classList.contains(`adw-icon--${normalizeIconName(vector.endIconName)}`)).toBe(
-                        true,
-                    );
+                //
+                // And the class is only HALF the answer. `external-link-symbolic` in these
+                // vectors is well formed, normalizes cleanly and gets its class — while no
+                // mask class of that name exists (it is in neither the Adwaita icon theme
+                // nor `@gjsify/adwaita-icons`), so it paints the image-missing glyph. This
+                // suite was green on that: the class-string assertion the icon work exists
+                // to end. `isIconAvailable` reads the live cascade, so it decides which of
+                // the two answers is right for THIS name instead of the test guessing.
+                for (const [index, declared, visible] of [
+                    [0, vector.startIconName, vector.startIconVisible],
+                    [1, vector.endIconName, vector.endIconVisible],
+                ] as const) {
+                    if (!visible) continue;
+                    const icon = icons[index]!;
+                    const resolved = normalizeIconName(declared);
+                    expect(icon.classList.contains(`adw-icon--${resolved}`)).toBe(true);
+                    expect(maskOf(icon)).not.toBe('none');
+                    expect(maskOf(icon) === fallbackMask()).toBe(!isIconAvailable(resolved));
                 }
                 host.remove();
             });

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

@@ -20,6 +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';
 
 /** Mount a button content inside a plain Adwaita button, the way the stories do. */
 function mount(attributes: Record<string, string> = {}): {
@@ -123,13 +124,17 @@ export const AdwButtonContentTest = async () => {
                 // asked for `.adw-icon--folder-download-symbolic`, a class that has
                 // never existed, and drew an empty 16px box. `<adw-icon>` applies
                 // `normalizeIconName`, which also makes the `' '` row assertable
-                // instead of skipped: a space is not one CSS token, so it draws
-                // nothing rather than injecting a second class.
+                // instead of skipped: a space is not one CSS token, so it lands on
+                // `image-missing` — the missing icon that row's own rule records GTK
+                // drawing there, by lookup failure rather than by this branch.
                 const maskName = normalizeIconName(resolved);
-                expect(icon.classList.contains(`adw-icon--${maskName}`)).toBe(maskName !== '');
-                expect([...icon.classList].filter((c) => c.startsWith('adw-icon--')).length).toBe(
-                    maskName === '' ? 0 : 1,
-                );
+                const drawn = maskName === '' ? 'image-missing' : maskName;
+                expect(icon.classList.contains(`adw-icon--${drawn}`)).toBe(true);
+                expect([...icon.classList].filter((c) => c.startsWith('adw-icon--')).length).toBe(1);
+                // …and it DRAWS that. The class alone is what the original bug survived:
+                // applied correctly, to a name with no glyph behind it.
+                expect(maskOf(icon)).not.toBe('none');
+                expect(maskOf(icon) === fallbackMask()).toBe(drawn === 'image-missing');
                 // The image node is never hidden — `gtk_widget_set_visible` is
                 // called on the LABEL only.
                 expect(icon.hidden).toBe(false);