From 99c9e2f8f08486e23d72660e568e121dce436e92 Mon Sep 17 00:00:00 2001
From: Nubenetes Bot <bot@nubenetes.com>
Date: Fri, 19 Jun 2026 14:32:32 +0200
Subject: [PATCH] fix: remove content-visibility from dense indexes (v2.9.2)

Removed `content-visibility: auto` on broad <ul>/<ol> selectors and
.v2-tag-section. On the slate (dark) theme it produced black flashes
while scrolling and made link lists below the index mosaic appear
collapsed/broken due to intrinsic-size mismatch causing scrollbar jumps.
The tags page already uses collapsed <details> (native render skipping),
so the optimization was redundant and harmful.

Bumped CSS cache-bust to ?v=2.9.2.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 docs/static/v2_elite.css | 19 +++++++------------
 v2-mkdocs.yml            |  2 +-
 2 files changed, 8 insertions(+), 13 deletions(-)

diff --git a/docs/static/v2_elite.css b/docs/static/v2_elite.css
index e2155020..01c95530 100644
--- a/docs/static/v2_elite.css
+++ b/docs/static/v2_elite.css
@@ -876,18 +876,13 @@ a {
 /* PERFORMANCE OPTIMIZATIONS FOR DENSE INDEXES          */
 /* ---------------------------------------------------- */
 
-/* Defer rendering of heavy tag sections on the tags index page */
-.v2-tag-section {
-  content-visibility: auto;
-  contain-intrinsic-size: auto 500px;
-}
-
-/* Defer rendering of large resource lists in category pages */
-.md-typeset > ul,
-.md-typeset > ol {
-  content-visibility: auto;
-  contain-intrinsic-size: auto 200px;
-}
+/* NOTE: `content-visibility: auto` was removed here (v2.9.2). It deferred
+   painting of off-screen <ul>/<ol> lists, which on the dark (slate) theme
+   produced black flashes while scrolling and made the link lists below the
+   index mosaic appear broken/collapsed (intrinsic-size mismatch caused
+   scrollbar jumps). The tags page already uses collapsed <details>, which
+   skip rendering natively, so the optimization was both redundant and
+   harmful. Do NOT reintroduce content-visibility on broad selectors. */
 
 /* Collapsible tag lists on the tags index page */
 .v2-tag-section details {
diff --git a/v2-mkdocs.yml b/v2-mkdocs.yml
index 9741bc06..76d78605 100644
--- a/v2-mkdocs.yml
+++ b/v2-mkdocs.yml
@@ -99,7 +99,7 @@ extra:
 extra_css:
   - https://fonts.googleapis.com/css2?family=Inter:wght@400;500;700&display=swap
   - static/extra.css
-  - static/v2_elite.css?v=2.7.0
+  - static/v2_elite.css?v=2.9.2
 
 extra_javascript:
   - static/v2_filter.js