plotjs 0.0.6__tar.gz → 0.0.8__tar.gz

plotjs-0.0.8/.github/workflows/tests-browser.yaml

@@ -0,0 +1,42 @@
+name: Tests Browser
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  browser-tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.13"]
+    env:
+      UV_PYTHON: ${{ matrix.python-version }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install the project
+        run: uv sync --all-groups
+
+      - name: Install Playwright browsers
+        run: uv run playwright install --with-deps chromium
+
+      - name: Run browser tests
+        run: uv run pytest tests/test-browser/ -v
+
+      - name: Upload test artifacts on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: browser-test-artifacts-${{ matrix.python-version }}
+          path: |
+            /tmp/pytest-of-*/
+          retention-days: 7

{plotjs-0.0.6 → plotjs-0.0.8}/.github/workflows/tests-python.yaml

@@ -26,5 +26,7 @@ jobs:
       - name: Install the project
         run: uv sync --all-groups
 
-      - name: Run tests
-        run: uv run pytest
+      - name: Run unit tests (excluding browser tests)
+        run: uv run pytest tests/test-python/ -v
+        env:
+          MPLBACKEND: Agg

plotjs-0.0.6/AGENTS.md → plotjs-0.0.8/AGENT.md

@@ -9,20 +9,26 @@ PlotJS is a Python package that transforms static matplotlib charts into interac
 ## Quick Architecture
 
 ```
-Matplotlib Figure → SVG Export (Python) → HTML Template (Jinja2) → Interactive Browser (D3.js)
+Matplotlib Figure → SVG Export (Python) → HTML Template (Jinja2) → Interactive Browser
 ```
 
-### Workflow:
-
 1. **Python (PlotJS class):** Captures matplotlib figure as SVG string, collects tooltip/styling metadata
 2. **Jinja2 Template:** Injects SVG + CSS + JavaScript parser + configuration into HTML
 3. **Browser (PlotSVGParser):** Parses SVG structure to identify plot elements, attaches hover interactivity
 
+## How to run command
+
+Always use `uv` and/or `just` for running commands:
+
+- `uv run pytest tests/test-python`
+- `uv run pytest tests/test-python`
+- `uv run python -c "import matplotlib"`
+
 ## Key Components
 
 ### Python Module (`/plotjs/`)
 
-**`main.py`** - Core `PlotJS` class with method chaining
+**`plotjs.py`** - Core `PlotJS` class with method chaining
 
 - `__init__(fig, **savefig_kws)` - Converts matplotlib figure to SVG
 - `add_tooltip(labels, groups, hover_nearest, ax)` - Configure hover tooltips
@@ -53,7 +59,7 @@ Matplotlib Figure → SVG Export (Python) → HTML Template (Jinja2) → Interac
 **`template.html`** - Jinja2 template structure
 
 - Injects: `{{ svg }}`, `{{ default_css }}`, `{{ additional_css }}`, `{{ js_parser }}`, `{{ plot_data_json }}`
-- Creates tooltip container and D3-based event handling
+- Creates tooltip container and event handling
 
 **`plotparser.js`** - `PlotSVGParser` JavaScript class
 
@@ -125,17 +131,17 @@ Optional `seed` parameter ensures deterministic UUID generation for consistent o
 ```
 plotjs/
 ├── __init__.py              # Package exports
-├── main.py                  # Core PlotJS class (330 lines)
-├── css.py                   # CSS utilities (100 lines)
-├── javascript.py            # JavaScript utilities (23 lines)
-├── utils.py                 # Internal helpers (43 lines)
+├── plotjs.py                  # Core PlotJS class
+├── css.py                   # CSS utilities
+├── javascript.py            # JavaScript utilities
+├── utils.py                 # Internal helpers
 ├── data/
 │   ├── datasets.py          # Sample datasets with Narwhals
 │   └── *.csv                # Data files
 └── static/
-    ├── template.html        # Jinja2 HTML template (104 lines)
-    ├── plotparser.js        # SVG parser class (229 lines)
-    └── default.css          # Default styles (41 lines)
+    ├── template.html        # Jinja2 HTML template
+    ├── plotparser.js        # SVG parser class
+    └── default.css          # Default styles
 
 tests/
 ├── test-python/             # Python unit tests
@@ -156,10 +162,6 @@ docs/                        # Comprehensive documentation
 - jinja2 >= 3.0.0 (HTML templating)
 - narwhals >= 2.0.0 (dataframe abstraction)
 
-**JavaScript (via CDN):**
-
-- d3 v7.9.0 (DOM manipulation via d3-selection)
-
 **Python Version:** Requires 3.10+
 
 ## Critical Patterns & Limitations

{plotjs-0.0.6 → plotjs-0.0.8}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Joseph Barbier
+Copyright (c) 2026 Joseph Barbier
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{plotjs-0.0.6/plotjs.egg-info → plotjs-0.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotjs
-Version: 0.0.6
+Version: 0.0.8
 Summary: Turn static matplotlib charts into interactive web visualizations
 Author-email: Joseph Barbier <joseph.barbierdarnal@mail.com>
 License-Expression: MIT

plotjs-0.0.8/docs/developers/svg-parser-reference.md

@@ -0,0 +1,164 @@
+## Classes
+
+<dl>
+<dt><a href="#Selection">Selection</a></dt>
+<dd><p>Lightweight Selection wrapper that mimics d3-selection&#39;s chainable API.
+Provides basic DOM manipulation methods for working with SVG elements.</p>
+</dd>
+</dl>
+
+## Functions
+
+<dl>
+<dt><a href="#select">select(selector)</a> ⇒ <code><a href="#Selection">Selection</a></code></dt>
+<dd><p>Create a Selection from a DOM element or selector string.</p>
+</dd>
+<dt><a href="#getPointerPosition">getPointerPosition(event, svgElement)</a> ⇒ <code>Array.&lt;number&gt;</code></dt>
+<dd><p>Get mouse position relative to an SVG element.</p>
+</dd>
+<dt><a href="#findBars">findBars(svg, axes_class)</a> ⇒ <code><a href="#Selection">Selection</a></code></dt>
+<dd><p>Find bar elements (<code>patch</code> groups with clipping) inside a given axes.</p>
+</dd>
+<dt><a href="#findPoints">findPoints(svg, axes_class, tooltip_groups)</a> ⇒ <code><a href="#Selection">Selection</a></code></dt>
+<dd><p>Find scatter plot points inside a given axes.
+Handles both <code>&lt;use&gt;</code> and <code>&lt;path&gt;</code> fallback cases,
+and assigns <code>data-group</code> attributes based on tooltip groups.</p>
+</dd>
+<dt><a href="#findLines">findLines(svg, axes_class)</a> ⇒ <code><a href="#Selection">Selection</a></code></dt>
+<dd><p>Find line elements (<code>line2d</code> paths) inside a given axes,
+excluding axis grid lines.</p>
+</dd>
+<dt><a href="#findAreas">findAreas(svg, axes_class)</a> ⇒ <code><a href="#Selection">Selection</a></code></dt>
+<dd><p>Find filled area elements (<code>FillBetweenPolyCollection</code> paths) inside a given axes.</p>
+</dd>
+<dt><a href="#nearestElementFromMouse">nearestElementFromMouse(mouseX, mouseY, elements)</a> ⇒ <code>Element</code> | <code>null</code></dt>
+<dd><p>Compute the nearest element to the mouse cursor from a set of elements.
+Uses bounding box centers for distance.
+This function is used when the <code>hover_nearest</code> argument is true.</p>
+</dd>
+<dt><a href="#setHoverEffect">setHoverEffect(plot_element, axes_class, tooltip_labels, tooltip_groups, show_tooltip, hover_nearest)</a></dt>
+<dd><p>Attach hover interaction and tooltip display to plot elements.
+Can highlight nearest element (if enabled) or hovered element directly.</p>
+</dd>
+</dl>
+
+<a name="Selection"></a>
+
+## Selection
+Lightweight Selection wrapper that mimics d3-selection's chainable API.
+Provides basic DOM manipulation methods for working with SVG elements.
+
+**Kind**: global class
+<a name="select"></a>
+
+## select(selector) ⇒ [<code>Selection</code>](#Selection)
+Create a Selection from a DOM element or selector string.
+
+**Kind**: global function
+**Returns**: [<code>Selection</code>](#Selection) - New Selection instance
+
+| Param | Type | Description |
+| --- | --- | --- |
+| selector | <code>string</code> \| <code>Element</code> | CSS selector string or DOM element |
+
+<a name="getPointerPosition"></a>
+
+## getPointerPosition(event, svgElement) ⇒ <code>Array.&lt;number&gt;</code>
+Get mouse position relative to an SVG element.
+
+**Kind**: global function
+**Returns**: <code>Array.&lt;number&gt;</code> - [x, y] coordinates relative to the SVG
+
+| Param | Type | Description |
+| --- | --- | --- |
+| event | <code>MouseEvent</code> | The mouse event |
+| svgElement | <code>Element</code> \| [<code>Selection</code>](#Selection) | The SVG element or Selection |
+
+<a name="findBars"></a>
+
+## findBars(svg, axes_class) ⇒ [<code>Selection</code>](#Selection)
+Find bar elements (`patch` groups with clipping) inside a given axes.
+
+**Kind**: global function
+**Returns**: [<code>Selection</code>](#Selection) - Selection of bar elements.
+
+| Param | Type | Description |
+| --- | --- | --- |
+| svg | [<code>Selection</code>](#Selection) | Selection of the SVG element. |
+| axes_class | <code>string</code> | ID of the axes group (e.g. "axes_1"). |
+
+<a name="findPoints"></a>
+
+## findPoints(svg, axes_class, tooltip_groups) ⇒ [<code>Selection</code>](#Selection)
+Find scatter plot points inside a given axes.
+Handles both `<use>` and `<path>` fallback cases,
+and assigns `data-group` attributes based on tooltip groups.
+
+**Kind**: global function
+**Returns**: [<code>Selection</code>](#Selection) - Selection of point elements.
+
+| Param | Type | Description |
+| --- | --- | --- |
+| svg | [<code>Selection</code>](#Selection) | Selection of the SVG element. |
+| axes_class | <code>string</code> | ID of the axes group (e.g. "axes_1"). |
+| tooltip_groups | <code>Array.&lt;string&gt;</code> | Group identifiers for tooltips, parallel to points. |
+
+<a name="findLines"></a>
+
+## findLines(svg, axes_class) ⇒ [<code>Selection</code>](#Selection)
+Find line elements (`line2d` paths) inside a given axes,
+excluding axis grid lines.
+
+**Kind**: global function
+**Returns**: [<code>Selection</code>](#Selection) - Selection of line elements.
+
+| Param | Type | Description |
+| --- | --- | --- |
+| svg | [<code>Selection</code>](#Selection) | Selection of the SVG element. |
+| axes_class | <code>string</code> | ID of the axes group. |
+
+<a name="findAreas"></a>
+
+## findAreas(svg, axes_class) ⇒ [<code>Selection</code>](#Selection)
+Find filled area elements (`FillBetweenPolyCollection` paths) inside a given axes.
+
+**Kind**: global function
+**Returns**: [<code>Selection</code>](#Selection) - Selection of area elements.
+
+| Param | Type | Description |
+| --- | --- | --- |
+| svg | [<code>Selection</code>](#Selection) | Selection of the SVG element. |
+| axes_class | <code>string</code> | ID of the axes group. |
+
+<a name="nearestElementFromMouse"></a>
+
+## nearestElementFromMouse(mouseX, mouseY, elements) ⇒ <code>Element</code> \| <code>null</code>
+Compute the nearest element to the mouse cursor from a set of elements.
+Uses bounding box centers for distance.
+This function is used when the `hover_nearest` argument is true.
+
+**Kind**: global function
+**Returns**: <code>Element</code> \| <code>null</code> - The nearest DOM element or `null`.
+
+| Param | Type | Description |
+| --- | --- | --- |
+| mouseX | <code>number</code> | X coordinate of the mouse relative to SVG. |
+| mouseY | <code>number</code> | Y coordinate of the mouse relative to SVG. |
+| elements | [<code>Selection</code>](#Selection) | Selection of candidate elements. |
+
+<a name="setHoverEffect"></a>
+
+## setHoverEffect(plot_element, axes_class, tooltip_labels, tooltip_groups, show_tooltip, hover_nearest)
+Attach hover interaction and tooltip display to plot elements.
+Can highlight nearest element (if enabled) or hovered element directly.
+
+**Kind**: global function
+
+| Param | Type | Description |
+| --- | --- | --- |
+| plot_element | [<code>Selection</code>](#Selection) | Selection of plot elements (points, lines, etc.). |
+| axes_class | <code>string</code> | ID of the axes group. |
+| tooltip_labels | <code>Array.&lt;string&gt;</code> | Tooltip labels for each element. |
+| tooltip_groups | <code>Array.&lt;string&gt;</code> | Group identifiers for each element. |
+| show_tooltip | <code>&quot;block&quot;</code> \| <code>&quot;none&quot;</code> | Whether to display tooltips. |
+| hover_nearest | <code>boolean</code> | If true, highlight nearest element instead of hovered one. |