@mkbabb/glass-ui 4.1.0 → 5.0.0

package/src/styles/index.css

@@ -102,11 +102,16 @@
  *                              Toast / Notification / Alert consume it (the three
  *                              tone maps collapse). Loads after cards.css (it reads
  *                              the same `--glass-bg-*` rung tokens cards.css/the
- *                              ladder mint) and before floating-panel.css.
- *   8. floating-panel.css    — .floating-panel + .floating-panel-item.
- *                              Component utility layer.
- *   9. transitions.css       — Vue <Transition> classes (fade, fade-slide,
- *                              pop, dialog-scale, dropdown, tab-fade).
+ *                              ladder mint).
+ *   8. floating-panel.css    — RETIRED (BI.W-GLASS-DEDUP / FAM-9): the
+ *                              `.floating-panel` fixed-overlay recipe had ZERO
+ *                              consumers; the still-live `.dropdown-menu-content`
+ *                              font/inner-pad rules moved to menu.css.
+ *   9. transitions.css       — Vue <Transition> classes (fade, tab-fade,
+ *                              route-enter, pane-swap, metric-swap, dock-in).
+ *                              BI.W-REGISTER-TABLE retired fade-slide/pop/
+ *                              dialog-scale/dropdown (census-dead) — overlay/menu
+ *                              enters ride the .glass-reveal data-reveal register.
  *  10. animations.css        — @keyframes for components consumed via
  *                              `animation:` properties in (9) and component
  *                              <style> blocks. Includes the §TOP-LAYER
@@ -143,8 +148,7 @@
  *  12. instrument-chassis.css — P-tranche component CSS (chassis bezel +
  *                              groove dividers). Loaded after utilities so
  *                              component-local recipes can override.
- *  13. hover-popover.css     — V.W3 popover-animation grammar.
- *  14. drawer.css            — AN.W3 detented bottom-sheet grammar (glass
+ *  13. drawer.css            — AN.W3 detented bottom-sheet grammar (glass
  *                             sheet surface + peek handle + snap-stop rules).
  *  15. segmented-tabs.css    — AX.W53 SegmentedTabs overflow/indicator grammar.
  *  16. select.css            — BA.W-EMISSION the PRECOMPILED Select content
@@ -153,8 +157,15 @@
  *                             bracket CVA class so the bound SHIPS in dist/glass-ui.css
  *                             regardless of consumer JIT reach. A structural utility
  *                             never depends on a content-scan; locked by proof:emission.
+ *  17. dialog-placement.css  — BI.W-DIALOG-PLACEMENT the PRECOMPILED Dialog
+ *                             side-slide positioning (the `[data-slot="dialog-content"]
+ *                             [data-placement]` position/inset/size rules — the Sheet
+ *                             fold) — the overlay-band emission INVERSE: moved off the
+ *                             dead CVA geometry utilities that broke the D7 configurator
+ *                             drawer so the positioning SHIPS regardless of consumer JIT
+ *                             reach; locked by proof:emission.
  *
- * Per-package component CSS lives at (12)-(16) (loaded after utilities so
+ * Per-package component CSS lives at (12)-(17) (loaded after utilities so
  * component-local recipes can override). New per-package CSS files append
  * to that tail.
  */
@@ -169,11 +180,16 @@
 @import "./dock-controls.css";
 @import "./cards.css";
 @import "./feedback-tone.css";
-@import "./floating-panel.css";
 @import "./transitions.css";
 @import "./animations.css";
+@import "./viz-reveal.css";
 @import "./scroll-driven.css";
 @import "./scroll-choreography.css";
+/* BG.W-SCROLL-SHRINK-UNIFY — the EXTERNALIZED <CardHeader shrink> scroll-shrink
+   choreography (lifted out of the CardHeader.vue <style scoped> block into ONE
+   global, un-hashed home; the shared @keyframes title-collapse SCALE leg). A
+   scroll-choreography partial — bucketed DEFERRED in critical-partition.mjs. */
+@import "./card-scroll.css";
 @import "./scroll-chrome.css";
 @import "./view-transition.css";
 @import "./utilities.css";
@@ -186,19 +202,32 @@
 @import "./menu.css";
 @import "./configurator.css";
 @import "./instrument-chassis.css";
-@import "./hover-popover.css";
+/* BI.W-OVERLAY-UNION — hover-popover.css DELETED: <HoverPopover> folded onto the
+   sealed <Popover trigger="hover"> union; its content rides the shared
+   glass-floating + glass-reveal recipe, so the bespoke .hover-popover-panel
+   substrate is dead. (clean break, no alias.) */
 @import "./drawer.css";
 @import "./segmented-tabs.css";
+/* BI.W-STYLE-REDRAIN — the SegmentedTabs additive DECORATION tail (the .glass-drag-lift
+   pull affordance + the data-eyeglass iOS-27 loupe register) carved out of
+   segmented-tabs.css to hold the no-god-module 500-line bound; @import-ed IMMEDIATELY
+   AFTER it (unlayered, unique selectors, source-order-after — byte-isomorphic). */
+@import "./tabs/segmented-tabs-drag.css";
 @import "./select.css";
+/* BI.W-DIALOG-PLACEMENT — the overlay-band Dialog side-slide structural positioning,
+   precompiled (the emission INVERSE, terminalized onto Dialog `placement` — the Sheet
+   fold): a [data-slot="dialog-content"][data-placement] rule so the side sheet's
+   position/inset/size ships in dist/glass-ui.css regardless of a consumer's Tailwind
+   content-scan reach (off the dead CVA geometry utilities that broke the D7 configurator
+   drawer). :where()-wrapped so a consumer sizing utility still wins. Locked by
+   proof:emission (overlay-band inverse clause). */
+@import "./dialog-placement.css";
 /* BA.W-ICON-CHIP — the <IconChip> section-color pop recipe + the three axes
    (duotone/bloom/reveal). A component partial; the token arms (--section-color-N
    / --muted) auto-flip under .dark so the chip is mode-robust by construction. */
 @import "./icon-chip.css";
-/* BB.W-BORDER-PROGRESS — progress IS the element's border: the masked-conic ring
-   consumption (the @property reg lives in tokens/property-regs.css §18). A
-   component partial; the conic + the radius-following mask-composite + the coverage
-   masks + the PRM milestone-pulse bracket. */
-@import "./border-progress.css";
+/* The thin, radius-following masked scroll-progress band. */
+@import "./scroll-progress-rim.css";
 
 /* BC.W-AX-COMPLETION-SEAL — the hero-scale earned-GOLD completion seal: a one-shot
    gold-draw mark (a `stroke-dashoffset` wipe on the 4 `@property` motion tokens
@@ -208,6 +237,16 @@
    compositor-only — the feedback-surface partial. */
 @import "./completion-seal.css";
 
+/* BI.W-DRAW-IN — the codified self-drawing arrival register (`.draw-rule` /
+   `[data-draw-in]`). A hairline / divider / underline draws ITSELF in via
+   `transform: scaleX(0→1)` (or a `clip-path: inset()` wipe) on the NO-OVERSHOOT
+   arrival ease `--ease-out-expo`, at `--draw-in-duration = calc(0.52s * --motion-
+   tempo)` — categorically NOT a spring (a rule that overshoots past its own end reads
+   as jitter). Closes UF-G6 (the "ad-hoc, too bouncy" masthead divider); the demo
+   masthead rule + CompletionSeal + HandMark are its recorded members. Compositor-only,
+   PRM-static. */
+@import "./draw-in.css";
+
 /* Ensure Tailwind scans glass-ui's compiled component templates for the utility
    classes they emit (CVA variant classes like text-destructive-foreground,
    layout utilities like h-full/shrink-0).

package/src/styles/menu.css

@@ -51,23 +51,38 @@
            The `2.75rem` literal fallback covers a consumer who unsets the token. */
         min-block-size: max(2rem, var(--touch-target, 2.75rem));
 
-        /* The lift transform rides the §6 spring register (`--spring-smooth`); the
+        /* The lift transform rides the §6 spring register (`--spring-smooth`)
+           paired with ITS OWN settle clock `--spring-smooth-duration` (the
+           per-spring-duration doctrine, W-GLASS-CAL Unit 3 / W-TEMPO — NOT the
+           generic `--duration-fast`, which re-timed the spring to a 0.2 s wall
+           clock and dragged a dead sub-pixel tail; BI.W-COMMAND-JITTER R5a). The
            surface props (background) ride the bezier `--ease-standard` via the
-           `.interactive-item` base transition (already declared there). The
-           explicit transform leg here pairs the spring with the lift. */
-        transition: translate var(--duration-fast) var(--spring-smooth);
+           `.interactive-item` base transition (already declared there). */
+        transition: translate var(--spring-smooth-duration) var(--spring-smooth);
         translate: 0 0;
     }
 
     /* Hover / keyboard-focus / reka internal-highlight / sub-trigger-open all
-       reach the SAME glass register (Combobox/Command/Select parity — the CVA
-       routes all three input modes through `data-[highlighted]`). */
+       reach the SAME glass BG register (Combobox/Command/Select parity — the CVA
+       routes all three input modes through `data-[highlighted]`). The TRANSLATE
+       lift is POINTER-ONLY (the rule below): reka sets `[data-highlighted]` for
+       KEYBOARD highlight too, so a lift on the bare `[data-highlighted]` restarts
+       a translate transition on EVERY arrow/keystroke → the command-palette
+       jitter (UF-G8; BI.W-COMMAND-JITTER R5b). Keyboard highlight + focus keep the
+       bg tint + color; only `:hover` lifts. */
     .glass-menu-row:hover:not([data-disabled]),
     .glass-menu-row:focus:not([data-disabled]),
     .glass-menu-row[data-highlighted]:not([data-disabled]),
     .glass-menu-row[data-state="open"]:not([data-disabled]) {
         background: var(--menu-row-bg);
         color: var(--accent-foreground);
+    }
+
+    /* The POINTER-ONLY lift (R5b) — a `:hover`-scoped translate the keyboard
+       highlight/focus never fires, so an arrow keystroke never restarts a lift
+       transition. The pointer still reads the lift on hover; the keyboard reads
+       the bg+color register above with no geometric restart. */
+    .glass-menu-row:hover:not([data-disabled]) {
         translate: 0 var(--menu-row-lift);
     }
 
@@ -125,3 +140,48 @@
         transition: none;
     }
 }
+
+/* ── The dropdown-menu content font + inner-pad (BI.W-GLASS-DEDUP — moved here from
+   the DELETED floating-panel.css; the `.floating-panel` fixed-overlay recipe had ZERO
+   consumers and retired with the file). These are the STILL-LIVE rules — the dropdown
+   content family reads its consumer-facing knobs here.
+
+   Font knob (Q.W3 Lane C / Qβ-F3): migrated out of the lone scoped `<style>` blocks on
+   `DropdownMenuContent.vue` + `DropdownMenuSubContent.vue`. `--dropdown-menu-font` is
+   the consumer knob (value.js overrides it to `var(--font-mono)`); the `, inherit`
+   fall-through MUST be preserved verbatim per the Qθ binding constraint.
+
+   Inner-pad (AZ.R5-4): the dropdown content family reads the shared `--panel-padding`
+   token — one override retunes every teleported menu surface.
+
+   UNLAYERED (like the retired scoped block + the floating-panel.css source) — no other
+   rule sets `font-family`/`padding` on these surfaces, so the cascade effect is identical. */
+.dropdown-menu-content,
+.dropdown-sub-content {
+    font-family: var(--dropdown-menu-font, inherit);
+    padding: var(--panel-padding);
+
+    /* ── The L11 menu-plate token surface (BI.W-MENU-TRIGGER — the value.js coordination
+       ask). ONE consumer-retunable menu token surface following the factored Menu grammar
+       (the `--dropdown-menu-font` precedent, same family): a consumer retunes the whole
+       Menu plate — click AND context trigger, content AND sub-content — via a single
+       `:root` override. Each knob is a PURE NO-OP at its default (it falls through to the
+       floating tier's own value) and preserves the glass-first identity: the
+       bg/border knobs re-point the tier's INPUT primitives (`--glass-bg-rung` /
+       `--glass-border-rung`) — the "override the primitive the composite reads, never the
+       composite" discipline — so the W55 adaptive oklab tint still darkens/lifts over the
+       consumer's value AND the forced-colors a11y fallback (which sets `background:
+       Canvas` / `border: 1px solid CanvasText` DIRECTLY on `.glass-floating`) still wins.
+       The shadow knob replaces the drop-shadow leg of the tier's box-shadow stack; its
+       default reproduces the floating stack EXACTLY by reading the same rung tokens, so
+       the under-shadow + reduced-transparency behaviour re-resolves in lockstep (and
+       forced-colors strips box-shadow regardless). */
+    --glass-bg-rung: var(--dropdown-menu-bg, var(--glass-bg-floating));
+    --glass-border-rung: var(--dropdown-menu-border, var(--glass-border-floating));
+    box-shadow: var(
+        --dropdown-menu-shadow,
+        var(--glass-material-rim),
+        var(--glass-under-shadow-vivid),
+        var(--glass-shadow-floating)
+    );
+}

package/src/styles/paper.css

@@ -1,29 +1,124 @@
 /*
- * paper.css — Paper-texture primitives
+ * paper.css — Paper-texture primitives (BG.W-PAPER-TEXTURE-UNIFY — ONE warm
+ * raster tooth PRIMARY; feTurbulence RETIRED as the primary, DEMOTED to an
+ * `@supports`-gated relief enhancement).
  *
  * Two composable Tailwind `@utility` declarations:
- *   - paper-underpaint: fixed, app-root, fullscreen SVG turbulence at z-index -1
- *   - paper-grain-overlay: ::after overlay for individual surfaces
+ *   - paper-underpaint: fixed, app-root, fullscreen tooth texture at z-index -1
+ *   - paper-grain-overlay: ::after tooth overlay for individual surfaces
  *
- * Texture: feTurbulence baseFrequency 0.65, 4 octaves, desaturated via
- * feColorMatrix, blended multiply (light) / soft-light (dark). Tiles ~60px.
+ * THE HISTORY the design is immune to (KS-PAPER §1.1): the paper register was
+ * built three times on procedural SVG noise; the user rejected the SVG-noise
+ * path TWICE ("disgusting metallic"). The class recurred a third time (D-2): the
+ * grey `saturate=0` tooth borrowed ALL its warmth from the substrate, so once
+ * the universal warm plane was retired, multiply desaturated surfaces below the
+ * C 0.02 warm floor and the tooth read metallic-gray. Two structural causes: (a)
+ * `feDiffuseLighting` computes normals from a noise bump-map → an anisotropic
+ * brushed-metal sheen ("specular IS the metal"); (b) grey-at-source warmth was
+ * borrowed, never baked.
+ *
+ * THE FIX — warmth BAKED AT SOURCE, no lighting primitive (KS-PAPER §3.Q1):
+ * `--paper-grain-tooth` is now a WARM RASTER tooth — a deterministic, engine-
+ * invariant, warm-ecru fiber weave composed from crossed `repeating-linear-
+ * gradient` fibers (two fine crossed bands at incommensurate periods + one
+ * coarse raking band; every stop a warm-ecru/umber `oklch()`, mean C ≈ 0.045,
+ * 2-3× the 0.020 warm floor). It reads warm over ANY substrate — bare, dark, or
+ * washed — the D-2 substrate-warmth dependency SEVERED. It has NO lighting
+ * primitive, NO normals, NO specular term: a warm raster cannot read metallic
+ * (KS-PAPER R2). All periods divide the 140px tile evenly → seamless repeat.
+ *
+ * THE DEMOTED feTurbulence — `--paper-grain-relief` (default `none`): the
+ * procedural noise survives ONLY as a capability-gated ENHANCEMENT, layered
+ * ABOVE the raster in the same `background-image` stack, NEVER load-bearing. It
+ * is a WARM-DUOTONE feTurbulence (the grey noise mapped umber→ecru through an
+ * `feComponentTransfer` `table` ramp) with NO `feDiffuseLighting`/lighting term
+ * (the metallic primitive is retired) at a partial layer alpha — a subtle warm
+ * fiber grain, never the sheen. sRGB-pinned, deterministic seed. Gated behind
+ * `@supports (backdrop-filter: blur(1px))` (the library's capable-engine probe)
+ * so a lean engine paints the always-warm raster alone.
+ *
+ * THE BLEND LAW (UNTOUCHED — the physically-true move): `multiply` (light — ink
+ * sinks into the paper's pits → darken) / `screen` (dark — fiber catches light →
+ * lighten). Baseline, sRGB-safe, identical both engines. Plain per-mode arms.
+ * The always-present `background-image` longhand + opacity-only engage discipline
+ * (design-idioms §12 anti-pop) survives the swap: opacity is the only engaged
+ * channel; the image is never `none → image`.
+ *
+ * THE LIBRARY FENCE: `--glass-grain-opacity` (0.025/0.045) is BYTE-UNTOUCHED —
+ * the calm glass whisper stands; paper is warm material, glass is a whisper. That
+ * separation IS the design (the register fence, KS-PAPER §3.Q3).
  */
 
+/* The ONE warm-ecru raster tooth — DRY single source, both utilities resolve it.
+   Deterministic, engine-invariant (no procedural noise), warm at SOURCE (every
+   stop a warm-ecru/umber oklch, C ≥ 0.02); the mix-blend-mode carries the
+   darken/lighten. All three fiber periods (2.8px / 3.5px / 7px) divide the 140px
+   tile → seamless repeat; the two fine bands run incommensurate (LCM 14px) so the
+   weave reads organic, not a clean grid. */
+:root {
+    --paper-grain-tooth:
+        repeating-linear-gradient(
+            28deg,
+            oklch(0.9 0.045 84 / 0.5) 0,
+            oklch(0.62 0.052 60 / 0.5) 1.4px,
+            oklch(0.9 0.045 84 / 0.5) 2.8px
+        ),
+        repeating-linear-gradient(
+            -64deg,
+            oklch(0.88 0.04 82 / 0.38) 0,
+            oklch(0.6 0.05 58 / 0.38) 1.75px,
+            oklch(0.88 0.04 82 / 0.38) 3.5px
+        ),
+        repeating-linear-gradient(
+            10deg,
+            oklch(0.85 0.05 78 / 0.28) 0,
+            oklch(0.7 0.055 66 / 0.28) 3.5px,
+            oklch(0.85 0.05 78 / 0.28) 7px
+        );
+    --paper-grain-tile: 140px;
+    /* The demoted feTurbulence relief is DROPPED by default — the everywhere
+       floor is the warm raster ALONE (KS-PAPER §3.Q1: the enhancement is never
+       load-bearing; DROP unless a capable engine warrants it). */
+    --paper-grain-relief: none;
+}
+
+/* feTurbulence DEMOTED — the warm-duotone fine-grain relief, gated behind the
+   library's capable-engine probe (`backdrop-filter`) and layered ABOVE the
+   raster. NO `feDiffuseLighting`/lighting term (the metallic primitive is
+   retired): the grey fractalNoise is mapped umber→ecru through an
+   `feComponentTransfer` `table` ramp and painted at a PARTIAL layer alpha, so it
+   reads as a subtle warm fiber grain over the raster, never a brushed-metal
+   sheen. sRGB-pinned, deterministic seed. On a lean engine the block is skipped
+   and the always-warm raster paints alone. */
+@supports (backdrop-filter: blur(1px)) {
+    :root {
+        --paper-grain-relief: url("data:image/svg+xml,%3Csvg width='120' height='120' viewBox='0 0 120 120' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='r' color-interpolation-filters='sRGB'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='2' seed='11' stitchTiles='stitch'/%3E%3CfeColorMatrix type='saturate' values='0'/%3E%3CfeComponentTransfer%3E%3CfeFuncR type='table' tableValues='0.31 0.96'/%3E%3CfeFuncG type='table' tableValues='0.25 0.9'/%3E%3CfeFuncB type='table' tableValues='0.15 0.78'/%3E%3CfeFuncA type='linear' slope='0.42' intercept='0.12'/%3E%3C/feComponentTransfer%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23r)'/%3E%3C/svg%3E");
+    }
+}
+
 @utility paper-underpaint {
     position: fixed;
     inset: 0;
     z-index: -1;
     pointer-events: none;
-    background-image: url("data:image/svg+xml,%3Csvg width='60' height='60' viewBox='0 0 60 60' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.65' numOctaves='4' stitchTiles='stitch'/%3E%3CfeColorMatrix type='saturate' values='0'/%3E%3CfeBlend mode='multiply' in2='SourceGraphic'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='1'/%3E%3C/svg%3E");
+    /* Two ALWAYS-PRESENT layers: the demoted relief (default `none` — paints
+       nothing) ABOVE the warm raster tooth. The layer count is stable (anti-pop);
+       on a lean engine `--paper-grain-relief` stays `none` so only the raster
+       paints, byte-identical in effect to a single-layer raster. A single
+       background-size applies to both layers. */
+    background-image: var(--paper-grain-relief), var(--paper-grain-tooth);
     background-repeat: repeat;
-    background-size: 60px 60px;
-    opacity: var(--glass-grain-opacity);
+    background-size: var(--paper-grain-tile) var(--paper-grain-tile);
+    opacity: var(--paper-grain-opacity, var(--glass-grain-opacity));
+    /* LIGHT: ink sinks into the cream → multiply darkens the valleys. */
     mix-blend-mode: multiply;
 }
 
 :where(.dark) .paper-underpaint,
 .dark .paper-underpaint {
-    mix-blend-mode: soft-light;
+    /* DARK: fiber catches light off the ink → screen lifts (NOT soft-light, which
+       collapses to identity on the near-black pole — the self-cancelling defect). */
+    mix-blend-mode: screen;
 }
 
 @utility paper-grain-overlay {
@@ -36,23 +131,47 @@
         inset: 0;
         border-radius: inherit;
         pointer-events: none;
-        background-image: url("data:image/svg+xml,%3Csvg width='60' height='60' viewBox='0 0 60 60' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.65' numOctaves='4' stitchTiles='stitch'/%3E%3CfeColorMatrix type='saturate' values='0'/%3E%3CfeBlend mode='multiply' in2='SourceGraphic'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='1'/%3E%3C/svg%3E");
+        /* The relief (default `none`) ABOVE the warm raster tooth — two
+           always-present layers, the anti-pop discipline (opacity is the only
+           engaged channel; the image is never `none → image`). */
+        background-image: var(--paper-grain-relief), var(--paper-grain-tooth);
         background-repeat: repeat;
-        background-size: 60px 60px;
-        opacity: var(--glass-grain-opacity);
-        mix-blend-mode: overlay;
+        background-size: var(--paper-grain-tile) var(--paper-grain-tile);
+        opacity: var(--paper-grain-opacity, var(--glass-grain-opacity));
+        /* LIGHT tooth: multiply — the physically-true ink-into-pits darken (NOT
+           overlay, which is identity on the L≈0.98 cream pole). */
+        mix-blend-mode: multiply;
     }
 }
 
 :where(.dark) .paper-grain-overlay::after,
 .dark .paper-grain-overlay::after {
-    mix-blend-mode: soft-light;
+    /* DARK tooth: screen — fiber catches light off the ink (NOT soft-light). */
+    mix-blend-mode: screen;
 }
 
+/* ═══════════════════════════════════════════════════════════════════════
+   BG.W-FIELD-AURORA — the WARM COLORFUL FIELD register is RETIRED here.
+   ───────────────────────────────────────────────────────────────────────
+   The `.paper-field` CSS plane (the per-route four-layer technicolor CEL +
+   base wash + cel-drift) is SUPERSEDED by the ONE shell `<Aurora>` (a
+   recessive vividness:0 painterly field) mounted in AppShell.vue behind every
+   NON-focal route. The grain register (`.paper-underpaint` /
+   `.paper-grain-overlay::after`) below is the SURVIVOR — a clean break, no
+   alias (`.paper-field`, its `.dark` arm, the `::before` cel-drift, the
+   `@keyframes field-cel-drift`, and the `--field-h-raw`/`--field-intensity`
+   @property regs are all DELETED). `proof:no-paper-field` asserts the recipe
+   ABSENT and the grain register PRESENT.
+   ═══════════════════════════════════════════════════════════════════════ */
+
 /* ═══════════════════════════════════════════════
    A11y — respect user motion + transparency preferences
    ═══════════════════════════════════════════════ */
 @media (prefers-reduced-transparency: reduce) {
+    /* The grain drops to 0-alpha under reduced transparency — it is a
+       transmissive enhancement, NEVER a legibility dependency. (The retired
+       `.paper-field` PRT line that shared this block is gone; the grain
+       register is the survivor.) */
     .paper-underpaint,
     .paper-grain-overlay::after {
         opacity: 0;