docs: refactor docs folder structure

Author: thalissonvs

mkdocs.yml

@@ -3,6 +3,7 @@ site_url: https://pydoll.tech/docs/
 repo_url: https://github.com/autoscrape-labs/pydoll
 repo_name: autoscrape-labs/pydoll
 use_directory_urls: true
+docs_dir: public/docs
 
 # Configuração da navegação
 nav:
@@ -84,7 +85,7 @@ theme:
   icon:
     repo: fontawesome/brands/github
     logo: material/lightning-bolt
-  favicon: images/favicon.png
+  favicon: ./images/favicon.png
   features:
     - navigation.tabs
     - navigation.tabs.sticky

public/docs/api/browser/chrome.md

@@ -0,0 +1,7 @@
+# Chrome Browser
+ 
+::: pydoll.browser.chromium.Chrome
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 2 

public/docs/api/browser/edge.md

@@ -0,0 +1,7 @@
+# Edge Browser
+ 
+::: pydoll.browser.chromium.Edge
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 2 

public/docs/api/browser/managers.md

@@ -0,0 +1,71 @@
+# Browser Managers
+
+The managers module provides specialized classes for managing different aspects of browser lifecycle and configuration.
+
+## Overview
+
+Browser managers handle specific responsibilities in browser automation:
+
+::: pydoll.browser.managers
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 2
+      filters:
+        - "!^_"
+        - "!^__"
+
+## Manager Classes
+
+### Browser Process Manager
+Manages the browser process lifecycle, including starting, stopping, and monitoring browser processes.
+
+::: pydoll.browser.managers.browser_process_manager
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 3
+
+### Browser Options Manager
+Handles browser configuration options and command-line arguments.
+
+::: pydoll.browser.managers.browser_options_manager
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 3
+
+### Proxy Manager
+Manages proxy configuration and authentication for browser instances.
+
+::: pydoll.browser.managers.proxy_manager
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 3
+
+### Temporary Directory Manager
+Handles creation and cleanup of temporary directories used by browser instances.
+
+::: pydoll.browser.managers.temp_dir_manager
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 3
+
+## Usage
+
+Managers are typically used internally by browser classes like `Chrome` and `Edge`. They provide modular functionality that can be composed together:
+
+```python
+from pydoll.browser.managers.proxy_manager import ProxyManager
+from pydoll.browser.managers.temp_dir_manager import TempDirManager
+
+# Managers are used internally by browser classes
+# Direct usage is for advanced scenarios only
+proxy_manager = ProxyManager()
+temp_manager = TempDirManager()
+```
+
+!!! note "Internal Usage"
+    These managers are primarily used internally by the browser classes. Direct usage is recommended only for advanced scenarios or when extending the library. 

public/docs/api/browser/options.md

@@ -0,0 +1,25 @@
+# Browser Options
+
+## ChromiumOptions
+
+::: pydoll.browser.options.ChromiumOptions
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 3
+
+## Options Interface
+
+::: pydoll.browser.interfaces.Options
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 3
+
+## BrowserOptionsManager Interface
+
+::: pydoll.browser.interfaces.BrowserOptionsManager
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 3 

public/docs/api/browser/requests.md

@@ -0,0 +1,139 @@
+# Browser Requests
+
+The requests module provides HTTP request capabilities within the browser context, enabling seamless API calls that inherit the browser's session state, cookies, and authentication.
+
+## Overview
+
+The browser requests module offers a `requests`-like interface for making HTTP calls directly within the browser's JavaScript context. This approach provides several advantages over traditional HTTP libraries:
+
+- **Session inheritance**: Automatic cookie, authentication, and CORS handling
+- **Browser context**: Requests execute in the same security context as the page
+- **No session juggling**: Eliminate the need to transfer cookies and tokens between automation and API calls
+- **SPA compatibility**: Perfect for Single Page Applications with complex authentication flows
+
+## Request Class
+
+The main interface for making HTTP requests within the browser context.
+
+::: pydoll.browser.requests.request.Request
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 3
+      group_by_category: true
+      members_order: source
+      filters:
+        - "!^__"
+
+## Response Class
+
+Represents the response from HTTP requests, providing a familiar interface similar to the `requests` library.
+
+::: pydoll.browser.requests.response.Response
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 3
+      group_by_category: true
+      members_order: source
+      filters:
+        - "!^__"
+
+## Usage Examples
+
+### Basic HTTP Methods
+
+```python
+from pydoll.browser.chromium import Chrome
+
+async with Chrome() as browser:
+    tab = await browser.start()
+    await tab.go_to("https://api.example.com")
+    
+    # GET request
+    response = await tab.request.get("/users/123")
+    user_data = await response.json()
+    
+    # POST request
+    response = await tab.request.post("/users", json={
+        "name": "John Doe",
+        "email": "[email protected]"
+    })
+    
+    # PUT request with headers
+    response = await tab.request.put("/users/123", 
+        json={"name": "Jane Doe"},
+        headers={"Authorization": "Bearer token123"}
+    )
+```
+
+### Response Handling
+
+```python
+# Check response status
+if response.ok:
+    print(f"Success: {response.status_code}")
+else:
+    print(f"Error: {response.status_code}")
+    response.raise_for_status()  # Raises HTTPError for 4xx/5xx
+
+# Access response data
+text_data = response.text
+json_data = await response.json()
+raw_bytes = response.content
+
+# Inspect headers and cookies
+print("Response headers:", response.headers)
+print("Request headers:", response.request_headers)
+for cookie in response.cookies:
+    print(f"Cookie: {cookie.name}={cookie.value}")
+```
+
+### Advanced Features
+
+```python
+# Request with custom headers and parameters
+response = await tab.request.get("/search", 
+    params={"q": "python", "limit": 10},
+    headers={
+        "User-Agent": "Custom Bot 1.0",
+        "Accept": "application/json"
+    }
+)
+
+# File upload simulation
+response = await tab.request.post("/upload",
+    data={"description": "Test file"},
+    files={"file": ("test.txt", "file content", "text/plain")}
+)
+
+# Form data submission
+response = await tab.request.post("/login",
+    data={"username": "user", "password": "pass"}
+)
+```
+
+## Integration with Tab
+
+The request functionality is accessed through the `tab.request` property, which provides a singleton `Request` instance for each tab:
+
+```python
+# Each tab has its own request instance
+tab1 = await browser.get_tab(0)
+tab2 = await browser.new_tab()
+
+# These are separate Request instances
+request1 = tab1.request  # Request bound to tab1
+request2 = tab2.request  # Request bound to tab2
+
+# Requests inherit the tab's context
+await tab1.go_to("https://site1.com")
+await tab2.go_to("https://site2.com")
+
+# These requests will have different cookie/session contexts
+response1 = await tab1.request.get("/api/data")  # Uses site1.com cookies
+response2 = await tab2.request.get("/api/data")  # Uses site2.com cookies
+```
+
+!!! tip "Hybrid Automation"
+    This module is particularly powerful for hybrid automation scenarios where you need to combine UI interactions with API calls. For example, log in through the UI, then use the authenticated session for API calls without manually handling cookies or tokens.

public/docs/api/browser/tab.md

@@ -0,0 +1,7 @@
+# Tab
+
+::: pydoll.browser.tab.Tab
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 2

public/docs/api/commands/browser.md

@@ -0,0 +1,41 @@
+# Browser Commands
+
+Browser commands provide low-level control over browser instances and their configuration.
+
+## Overview
+
+The browser commands module handles browser-level operations such as version information, target management, and browser-wide settings.
+
+::: pydoll.commands.browser_commands
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 2
+      filters:
+        - "!^_"
+        - "!^__"
+
+## Usage
+
+Browser commands are typically used internally by browser classes to manage browser instances:
+
+```python
+from pydoll.commands.browser_commands import get_version
+from pydoll.connection.connection_handler import ConnectionHandler
+
+# Get browser version information
+connection = ConnectionHandler()
+version_info = await get_version(connection)
+```
+
+## Available Commands
+
+The browser commands module provides functions for:
+
+- Getting browser version and user agent information
+- Managing browser targets (tabs, windows)
+- Controlling browser-wide settings and permissions
+- Handling browser lifecycle events
+
+!!! note "Internal Usage"
+    These commands are primarily used internally by the `Chrome` and `Edge` browser classes. Direct usage is recommended only for advanced scenarios. 

public/docs/api/commands/dom.md

@@ -0,0 +1,58 @@
+# DOM Commands
+
+DOM commands provide comprehensive functionality for interacting with the Document Object Model of web pages.
+
+## Overview
+
+The DOM commands module is one of the most important modules in Pydoll, providing all the functionality needed to find, interact with, and manipulate HTML elements on web pages.
+
+::: pydoll.commands.dom_commands
+    options:
+      show_root_heading: true
+      show_source: false
+      heading_level: 2
+      filters:
+        - "!^_"
+        - "!^__"
+
+## Usage
+
+DOM commands are used extensively by the `WebElement` class and element finding methods:
+
+```python
+from pydoll.commands.dom_commands import query_selector, get_attributes
+from pydoll.connection.connection_handler import ConnectionHandler
+
+# Find element and get its attributes
+connection = ConnectionHandler()
+node_id = await query_selector(connection, selector="#username")
+attributes = await get_attributes(connection, node_id=node_id)
+```
+
+## Key Functionality
+
+The DOM commands module provides functions for:
+
+### Element Finding
+- `query_selector()` - Find single element by CSS selector
+- `query_selector_all()` - Find multiple elements by CSS selector
+- `get_document()` - Get the document root node
+
+### Element Interaction
+- `click_element()` - Click on elements
+- `focus_element()` - Focus elements
+- `set_attribute_value()` - Set element attributes
+- `get_attributes()` - Get element attributes
+
+### Element Information
+- `get_box_model()` - Get element positioning and dimensions
+- `describe_node()` - Get detailed element information
+- `get_outer_html()` - Get element HTML content
+
+### DOM Manipulation
+- `remove_node()` - Remove elements from DOM
+- `set_node_value()` - Set element values
+- `request_child_nodes()` - Get child elements
+
+!!! tip "High-Level APIs"
+    While these commands provide powerful low-level access, most users should use the higher-level `WebElement` class methods like `click()`, `type_text()`, and `get_attribute()` which use these commands internally.