Merge pull request #9 from deeleeramone/feature/tradingview

Feature/tradingview

Author: deeleeramone

pywry/AGENTS.md

@@ -35,6 +35,7 @@ Built on [PyTauri](https://pypi.org/project/pytauri/) (which uses Rust's [Tauri]
 - **Security**: Scoped token auth enabled by default, CSP headers, internal API protection, production presets available
 - **AgGrid Tables**: Best-in-class Pandas → AgGrid conversion with pre-wired events, context menus, and practical defaults
 - **Plotly Charts**: Plotly rendering with pre-wired plot events for Dash-like interactivity
+- **TradingView Charts**: TradingView Lightweight Charts integration with OHLCV normalization, multi-series, indicators, and toolbar-driven controls
 - **Toast Notifications**: Built-in alert system with positioning (info, success, warning, error, confirm)
 - **Marquee Ticker**: Scrolling text/content with dynamic updates
 - **Secrets Handling**: Secure password inputs — values stored server-side, never rendered in HTML
@@ -123,6 +124,8 @@ pywry/
 ├── asset_loader.py      # CSS/JS file loading with caching
 ├── grid.py              # AgGrid Pydantic models (ColDef, GridOptions, etc.)
 ├── plotly_config.py     # Plotly configuration models (PlotlyConfig, ModeBarButton, etc.)
+├── tvchart_config.py    # TradingView chart config models (TVChartConfig, SeriesConfig, etc.)
+├── tvchart.py           # OHLCV data normalization and toolbar factory
 ├── toolbar.py           # Toolbar component models (Button, Select, etc.)
 ├── state_mixins.py      # Widget state management mixins
 ├── hot_reload.py        # Hot reload manager
@@ -196,7 +199,7 @@ from pywry.grid import ColDef, ColGroupDef, DefaultColDef, RowSelection, GridOpt
 from pywry import GridStateMixin, PlotlyStateMixin, ToolbarStateMixin
 
 # Inline functions (for notebooks)
-from pywry.inline import show_plotly, show_dataframe, block, stop_server
+from pywry.inline import show_plotly, show_dataframe, show_tvchart, block, stop_server
 
 # Notebook detection
 from pywry import NotebookEnvironment, detect_notebook_environment, is_anywidget_available, should_use_inline_rendering
@@ -308,6 +311,22 @@ handle = app.show_dataframe(
     on_row_selected=None,       # Row selection callback (notebook mode)
     server_side=False,          # Use server-side mode for large datasets
 )
+
+# Show TradingView Lightweight Chart
+handle = app.show_tvchart(
+    data,                       # OHLCV DataFrame, list of dicts, or dict of lists
+    title=None,
+    width=None,
+    height=None,
+    callbacks=None,
+    chart_options=None,         # Chart-level options (layout, grid, etc.)
+    series_options=None,        # Series-specific options (colors, etc.)
+    symbol_col=None,            # Column name for multi-series grouping
+    max_bars=10_000,
+    toolbars=None,
+    on_click=None,
+    on_crosshair=None,
+)
 ```
 
 ### HtmlContent Model

pywry/build_assets.py

@@ -15,6 +15,7 @@
     "https://cdn.jsdelivr.net/npm/ag-grid-community@35.0.0/dist/ag-grid-community.min.js"
 )
 AGGRID_CSS_BASE_URL = "https://cdn.jsdelivr.net/npm/ag-grid-community@35.0.0/styles"
+TVCHART_JS_URL = "https://cdn.jsdelivr.net/npm/lightweight-charts@5.1.0/dist/lightweight-charts.standalone.production.js"
 
 # Asset directory
 ASSETS_DIR = Path(__file__).parent / "pywry" / "frontend" / "assets"
@@ -121,6 +122,16 @@ def download_aggrid_css() -> bool:
     return success
 
 
+def download_tvchart_js() -> bool:
+    """Download TradingView Lightweight Charts JS library."""
+    dest = ASSETS_DIR / "lightweight-charts-5.1.0.standalone.production.js"
+    gz_dest = Path(str(dest) + ".gz")
+    if gz_dest.exists():
+        print(f"Lightweight Charts JS already exists at {gz_dest}")
+        return True
+    return download_file(TVCHART_JS_URL, dest, "Lightweight Charts v5.1.0")
+
+
 def create_placeholder_files() -> None:
     """Create placeholder files if downloads fail."""
     placeholder_files = [
@@ -130,6 +141,10 @@ def create_placeholder_files() -> None:
             b"// AG Grid placeholder - download failed\n",
         ),
         ("ag-grid-35.0.0.css.gz", b"/* AG Grid CSS placeholder - download failed */\n"),
+        (
+            "lightweight-charts-5.1.0.standalone.production.js.gz",
+            b"// Lightweight Charts placeholder - download failed\n",
+        ),
     ]
 
     for filename, content in placeholder_files:
@@ -153,6 +168,7 @@ def download_all_assets() -> bool:
         download_plotly_js(),
         download_aggrid_js(),
         download_aggrid_css(),
+        download_tvchart_js(),
     ]
 
     success = all(results)
@@ -176,6 +192,7 @@ def verify_assets() -> dict[str, bool]:
         "plotly-3.3.1.js.gz",  # Full bundle with templates
         "ag-grid-community-35.0.0.min.js.gz",
         "ag-grid-35.0.0.css.gz",
+        "lightweight-charts-5.1.0.standalone.production.js.gz",
     ]
 
     return {asset: (ASSETS_DIR / asset).exists() for asset in required_assets}

pywry/docs/docs/changelog.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## Unreleased
+
+### New Features
+
+- **Plotly dual-theme templates** — `PlotlyConfig` now accepts `template_dark` and `template_light` dicts that are deep-merged on top of the built-in `plotly_dark` / `plotly_white` base templates. User overrides always win; un-set values inherit from the base. Both templates survive theme switches via `pywry:update-theme`.
+
 ## Version 2.0.0
 
 PyWry 2.0 is a major release with a completely redesigned architecture and API.

pywry/docs/docs/guides/chat.md pywry/docs/docs/components/chat/index.mdpywry/docs/docs/guides/chat.md renamed to pywry/docs/docs/components/chat/index.md

@@ -7,7 +7,7 @@ PyWry includes a first-class chat UI that can run in native windows, notebook wi
 
 If you are building an interactive assistant, use `ChatManager` unless you explicitly need to assemble the raw chat HTML yourself.
 
-For the complete API surface, see the [Chat API](../reference/chat.md), [ChatManager API](../reference/chat-manager.md), and [Chat Providers API](../reference/chat-providers.md).
+For the complete API surface, see the [Chat API](../../reference/chat.md), [ChatManager API](../../reference/chat-manager.md), and [Chat Providers API](../../integrations/chat/chat-providers.md).
 
 ## Minimal ChatManager Setup
 
@@ -276,7 +276,7 @@ This returns only the chat HTML structure. You are then responsible for wiring t
 
 ## Next Steps
 
-- [Chat Artifacts And Providers](chat-artifacts.md)
-- [Chat API](../reference/chat.md)
-- [ChatManager API](../reference/chat-manager.md)
-- [Chat Providers API](../reference/chat-providers.md)
+- [Chat Artifacts And Providers](../../integrations/chat/index.md)
+- [Chat API](../../reference/chat.md)
+- [ChatManager API](../../reference/chat-manager.md)
+- [Chat Providers API](../../integrations/chat/chat-providers.md)

…wry/docs/docs/guides/content-assembly.md …mponents/htmlcontent/content-assembly.mdpywry/docs/docs/guides/content-assembly.md renamed to pywry/docs/docs/components/htmlcontent/content-assembly.md pywry/docs/docs/guides/content-assembly.md renamed to pywry/docs/docs/components/htmlcontent/content-assembly.md

@@ -365,7 +365,7 @@ This exact same assembly runs for all rendering paths — native, notebook, and
 
 ## Next Steps
 
-- **[app.show()](app-show.md)** — The full `show()` method and its parameters
-- **[HtmlContent](html-content.md)** — Controlling CSS, JS, and data injection
-- **[Event System](events.md)** — How the JavaScript bridge communicates with Python
-- **[Configuration](configuration.md)** — Global settings, asset paths, and security
+- **[app.show()](../../guides/app-show.md)** — The full `show()` method and its parameters
+- **[HtmlContent](index.md)** — Controlling CSS, JS, and data injection
+- **[Event System](../../guides/events.md)** — How the JavaScript bridge communicates with Python
+- **[Configuration](../../guides/configuration.md)** — Global settings, asset paths, and security

pywry/docs/docs/guides/html-content.md …ocs/docs/components/htmlcontent/index.mdpywry/docs/docs/guides/html-content.md renamed to pywry/docs/docs/components/htmlcontent/index.md pywry/docs/docs/guides/html-content.md renamed to pywry/docs/docs/components/htmlcontent/index.md

@@ -26,15 +26,26 @@ app.show(content)
 
 ## Fields
 
-| Field | Type | Default | Description |
-|---|---|---|---|
-| `html` | `str` | *(required)* | The HTML content to render — a fragment or a complete document |
-| `css_files` | `list[Path | str]` | `None` | Paths to CSS files to inject as `<style>` tags |
-| `script_files` | `list[Path | str]` | `None` | Paths to JavaScript files to inject as `<script>` tags |
-| `inline_css` | `str` | `None` | Raw CSS string injected as a `<style>` tag |
-| `json_data` | `dict` | `None` | Data injected as `window.json_data` in the page |
-| `init_script` | `str` | `None` | JavaScript code executed after all other scripts load |
-| `watch` | `bool` | `False` | Enable hot reload watching for `css_files` and `script_files` |
+`html`
+:   **`str`** *(required)* — The HTML content to render — a fragment or a complete document.
+
+`css_files`
+:   **`list[Path | str]`** — Paths to CSS files to inject as `<style>` tags. Default: `None`.
+
+`script_files`
+:   **`list[Path | str]`** — Paths to JavaScript files to inject as `<script>` tags. Default: `None`.
+
+`inline_css`
+:   **`str`** — Raw CSS string injected as a `<style>` tag. Default: `None`.
+
+`json_data`
+:   **`dict`** — Data injected as `window.json_data` in the page. Default: `None`.
+
+`init_script`
+:   **`str`** — JavaScript code executed after all other scripts load. Default: `None`.
+
+`watch`
+:   **`bool`** — Enable hot reload watching for `css_files` and `script_files`. Default: `False`.
 
 ## HTML: Fragment vs. Complete Document
 
@@ -203,7 +214,7 @@ You can also override `watch` at the `app.show()` level:
 app.show(content, watch=True)
 ```
 
-See the [Hot Reload guide](hot-reload.md) for the full implementation details.
+See the [Hot Reload guide](../../guides/hot-reload.md) for the full implementation details.
 
 ## Passing HtmlContent vs. Strings
 
@@ -242,6 +253,6 @@ The toolbar HTML wraps `HtmlContent.html` at build time. See [Content Assembly](
 ## Next Steps
 
 - **[Content Assembly](content-assembly.md)** — How PyWry builds the final HTML document
-- **[app.show()](app-show.md)** — The full `show()` method reference
-- **[Hot Reload](hot-reload.md)** — Live CSS/JS updates during development
-- **[Theming & CSS](theming.md)** — Theme system and CSS variables
+- **[app.show()](../../guides/app-show.md)** — The full `show()` method reference
+- **[Hot Reload](../../guides/hot-reload.md)** — Live CSS/JS updates during development
+- **[Theming & CSS](../theming.md)** — Theme system and CSS variables