Feat/test dependency

[YoussefMehany]

This pull request introduces a new modular and extensible browser automation framework, adds robust configuration management, and refactors core integration points to support easier usage and testing. The main themes are the addition of new browser and crawler subsystems, improved configuration handling, and enhanced element interaction logic.

New browser subsystem:

• Introduced a modular browser package with lazy-imported BrowserEngine, plus new utilities for browser actions (BrowserActions), frame resolution (FrameResolver), page management (PageManager), state capture (StateManager), JavaScript loading (JsLoader), and storage state normalization. These utilities encapsulate browser automation, error handling, and state tracking. [1] [2] [3] [4] [5] [6] [7]

Crawler subsystem improvements:

• Added a new crawler package with lazy-imported core classes (CrawlSession, ActionRepeatLimiter, etc.) and a new enums module defining ActionType, HtmlTag, and InputType for strong typing of crawler actions and elements. [1] [2]

Configuration management overhaul:

• Refactored Config to use a dataclass with a from_env constructor, supporting type-checked, slot-based configuration, and automatic environment variable parsing for all settings.
• Updated the project structure to include a pyproject.toml for modern Python packaging and dependency management.

Element interaction and identification enhancements:

• Improved interactable element detection in get_interactable_elements.js to use visible text for selectors (especially for buttons and links), and enhanced signature generation for more robust element identification. [1] [2]

Integration and usage refactoring:

• Refactored example_usage.py to use the new create_graph interface, updated configuration paths, and improved resource cleanup. [1] [2] [3]
• Removed the unused element_display_hint function for code cleanliness.

These changes lay the foundation for a scalable, testable, and maintainable browser crawling and testing framework.