Align recording dialog behavior and shell theme styling

docs/configuration.md

@@ -146,8 +146,9 @@ these six visually distinct.
 | `shadow` | `"#00000055"` | Window shadow color |
 
 Ferese derives the text and icon color for filled accent controls from the
-configured theme. It keeps the configured text color when it reaches a 4.5:1
-contrast ratio; otherwise it chooses black or white. The same rule is shared by
+configured theme. It keeps the configured text color and, when necessary, shades
+the accent fill slightly to reach a 4.5:1 contrast ratio. If that would require a
+large color change, it chooses black or white instead. The same rule is shared by
 native dialogs, settings selections, and notification badges. Hover, pressed,
 and disabled accent-button states use the same policy. Small filled controls
 resolve accent transparency against their theme surface so wallpaper cannot