[Refactor]: Improve type safety for browser preferences

[thalissonvs]

Currently, browser_preferences in ChromiumOptions is a generic dict without type safety, making it error-prone and difficult to maintain.

Problems:

No type validation: _browser_preferences: dict accepts any structure Unsafe path access: _set_pref_path(path: list, value) - no type checking on paths or values Silent failures: _get_pref_path() returns None without proper Optional typing Generic exception: WrongPrefsDict doesn't indicate what's wrong No autocomplete: IDE can't suggest available preference keys

Proposed Solution:

1. Create TypedDict for preferences structure:

from typing import TypedDict, NotRequired

class DownloadPreferences(TypedDict, total=False):
    default_directory: str
    prompt_for_download: bool

class ProfilePreferences(TypedDict, total=False):
    password_manager_enabled: bool
    default_content_setting_values: NotRequired[dict[str, int]]

class BrowserPreferences(TypedDict, total=False):
    download: DownloadPreferences
    profile: ProfilePreferences
    intl: NotRequired[dict[str, str]]
    plugins: NotRequired[dict[str, bool]]
    credentials_enable_service: bool

2. Update method signatures
3. Add specific exceptions
4. Add preference path validation

[ArthurRodrigues4433]

Hi! I’m interested in helping to solve this issue. I’m still learning, but I would like to try implementing type-safe browser preferences using TypedDict. I’m open to guidance and feedback while working on it.

[thalissonvs]

Hello, please feel free to test. If you need something, just let me know

[ArthurRodrigues4433]

Friend, can we communicate in Portuguese? I'm not very good at English yet.

[ArthurRodrigues4433]

Consegui subir a PR só falta revisão e um Feedback!

[thalissonvs]

Vou dar uma olhada assim que puder, obrigado