🎨 Palette: Improve drilldown navigation accessibility

.Jules/palette.md

@@ -0,0 +1,3 @@
+## 2024-06-12 - [Accessible Drilldown Navigation]
+**Learning:** When building progressive disclosure or drilldown navigation components, visual indicators of progress are insufficient for screen reader users. The dynamic updates (like changing levels) need to be explicitly announced, and the current position within the drilldown flow must be semantically communicated.
+**Action:** Always wrap drilldown breadcrumbs in a `<nav aria-label="Breadcrumb">` region, mark the active step with `aria-current="step"`, and use an `aria-live="polite"` region for dynamic counters (e.g., "Level 2 of 4") to create an inclusive and accessible disclosure experience. Additionally, ensure all interactive controls have high-contrast `focus-visible` rings for keyboard navigation.

src/components/drilldown/drilldown-navigation.tsx

@@ -56,25 +56,29 @@ export function DrilldownNavigation({
   return (
     <div className={clsx('flex flex-col', className)}>
       {/* Navigation Breadcrumb */}
-      <div className="flex items-center gap-2 mb-4 text-sm text-neutral-400">
+      <nav
+        aria-label="Breadcrumb"
+        className="flex items-center gap-2 mb-4 text-sm text-neutral-400"
+      >
         {levels.map((level, idx) => (
           <div key={level.id} className="flex items-center gap-2">
             <button
               onClick={() => {
                 setCurrentLevel(idx)
                 onLevelChange?.(level.id)
               }}
+              aria-current={idx === currentLevel ? 'step' : undefined}
               className={clsx(
-                'hover:text-neutral-200 transition-colors',
+                'hover:text-neutral-200 transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-neutral-400 rounded',
                 idx === currentLevel && 'text-neutral-200 font-medium'
               )}
             >
               {level.title}
             </button>
-            {idx < levels.length - 1 && <ChevronRight className="size-4" />}
+            {idx < levels.length - 1 && <ChevronRight className="size-4" aria-hidden="true" />}
           </div>
         ))}
-      </div>
+      </nav>
 
       {/* Current Level Content */}
       <div className="flex-1">{current.content}</div>
@@ -85,34 +89,34 @@ export function DrilldownNavigation({
           onClick={handleBack}
           disabled={currentLevel === 0}
           className={clsx(
-            'flex items-center gap-2 px-4 py-2 rounded-md text-sm font-medium transition-opacity',
+            'flex items-center gap-2 px-4 py-2 rounded-md text-sm font-medium transition-opacity focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-neutral-400',
             'hover:opacity-80',
             currentLevel === 0
               ? 'opacity-50 cursor-not-allowed text-neutral-500'
               : 'text-neutral-300'
           )}
         >
-          <ChevronLeft className="size-4" />
+          <ChevronLeft className="size-4" aria-hidden="true" />
           Back
         </button>
 
-        <div className="text-xs text-neutral-500">
+        <div aria-live="polite" className="text-xs text-neutral-500">
           Level {currentLevel + 1} of {levels.length}
         </div>
 
         <button
           onClick={handleNext}
           disabled={currentLevel === levels.length - 1}
           className={clsx(
-            'flex items-center gap-2 px-4 py-2 rounded-md text-sm font-medium transition-opacity',
+            'flex items-center gap-2 px-4 py-2 rounded-md text-sm font-medium transition-opacity focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-neutral-400',
             'hover:opacity-80',
             currentLevel === levels.length - 1
               ? 'opacity-50 cursor-not-allowed text-neutral-500'
               : 'text-neutral-300'
           )}
         >
           Next
-          <ChevronRight className="size-4" />
+          <ChevronRight className="size-4" aria-hidden="true" />
         </button>
       </div>
     </div>