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

docs/screen-sharing.md

@@ -27,10 +27,15 @@ may remain at the path shown in the error.
 Use a Wayland screen-sharing or recording source in your application. Ferese
 opens a display picker. Select a display and press **Share**. Nothing is selected
 by default. Applications that request multiple displays can share up to four.
-The picker uses your Ferese theme colors, font, and shell corner radius.
+The picker uses your Ferese theme colors, font, and shell corner radius. Its
+background follows `theme.material.style`: opaque in solid mode, or translucent
+using `theme.surface.popover.opacity`. Text and icons remain opaque.
 
-A **screen sharing** window remains visible while sharing. Press **Stop sharing**
-or close that window to revoke the session. Closing the requesting application,
+Other applications keep a **screen sharing** window with a **Stop sharing** button.
+Ferese’s built-in recorder uses the top-bar stop control instead, leaving your
+windows accessible after display selection. The command-line recorder keeps the
+sharing window when it is not launched by the shell. Press **Stop sharing** or
+close the sharing window to revoke an ordinary application’s session. Closing the requesting application,
 locking Ferese, disconnecting the selected display, or changing its capture size
 also ends sharing. A new request needs fresh consent; selections are not saved.
 Everything visible on a shared display, including notifications, is included.