fastplotpy 0.3.0a1__tar.gz

fastplotpy-0.3.0a1/AGENTS.md

@@ -0,0 +1,61 @@
+# Agent Bootstrap
+
+Start every new task by reading:
+
+1. `docs/DOCS_INDEX.md`
+2. `docs/PROJECT_STATUS.md`
+
+`docs/PROJECT_STATUS.md` is the project status source of truth, including implementation state, roadmap, CI expectations, and recent changes.
+
+## Default Regression Check
+
+After code changes, run:
+
+- `python -m unittest discover -s tests`
+- `python -m build`
+
+The tests exercise Python scenes, the optional pinned Rust binding, and source-derived contracts. Build a wheel and source distribution, then validate installation outside this checkout before a release claim. The source fastPlotJs Node/WASM gates do not validate the Python package.
+
+## Role Routing
+
+Use the narrowest role that matches the user's request. A task can move through more than one role, but do not widen scope beyond what the role requires.
+
+These are reusable task functions, not permanent appointments. An agent may perform one only within a specific authorized task; its authority ends when that assignment is completed or revoked.
+
+| Trigger | Role | Default behavior |
+| --- | --- | --- |
+| Project resume, "continue", "what is next", or unclear chart-library requests | Project Orchestrator | Read `docs/DOCS_INDEX.md` and `docs/PROJECT_STATUS.md`, check git state, identify the next small slice, and route the work to the right specialist role. |
+| Product direction, target users, use cases, requirements, priorities, roadmap, acceptance criteria, adoption hypotheses, compatibility/deprecation scope, or product status | Product Manager Agent | Read `docs/agents/PRODUCT_MANAGER.md`; frame task-scoped product recommendations, collaborate with qualified technical specialists, and escalate portfolio conflicts or cross-project tradeoffs through the task's authorized decision path. |
+| Public API, SemVer, `createChart()`, option semantics, defaults, or release compatibility | API Steward | Protect public API stability, reconcile README examples with Python exports and API stability docs, and avoid breaking changes without an explicit versioning decision. |
+| Rust scene generation, layout, downsampling, data processing, or performance-sensitive internals | Rust Core Agent | Keep core changes scoped, preserve Python/Rust contract behavior, and pair perf-sensitive work with targeted tests or benchmarks when risk warrants it. |
+| Rust bindings, pinned browser frontend, Python wrappers, engine fallback, or packaging surfaces | Bindings Agent | Keep browser and Python behavior aligned, preserve strict `engine` semantics, and update bindings tests or smoke checks when public behavior changes. |
+| Browser examples, interaction behavior, viewport controls, drag modes, legends, or visible chart behavior | Examples Agent | Keep examples runnable and representative, update example code with API changes, and verify browser behavior when UI interaction is the requested surface. |
+| Performance guard, benchmark baselines, regression thresholds, or release-readiness perf questions | Performance Agent | Treat source benchmarks as upstream context until equivalent Python baselines exist, separate environment noise from real regressions, and do not update baselines without an explicit decision. |
+| Project status, API stability docs, release notes, publish readiness, or documentation index updates | Docs/Release Agent | Update canonical Markdown, keep `docs/DOCS_INDEX.md` current for new docs, and block publish readiness claims until gates and docs agree. |
+| Review-only requests | Reviewer | Stay read-only unless fixes are explicitly requested. Lead with bugs, regressions, API drift, missing tests, performance risk, and exact file references. |
+
+## Documentation Rules
+
+- `docs/DOCS_INDEX.md` tracks all project Markdown files outside `node_modules`.
+- When adding a new Markdown file, update `docs/DOCS_INDEX.md` in the same change.
+- Keep long-lived project context in `docs/PROJECT_STATUS.md`; do not create a separate handoff file unless the project status document becomes too large to maintain.
+- Any feature that adds or changes user-visible UI behavior must include a runnable example under `examples/` in the same task slice.
+
+## Branch Workflow
+
+- Before implementation or documentation work, create or switch to a dedicated working branch instead of committing directly on `main`.
+- Branch names must not use a `codex/` prefix.
+- Use `feature/...` for new features.
+- Use `bugfix/...` for bug fixes.
+- Use `hotfix/...` for urgent hot fixes.
+- Use `release/...` for release preparation or release-evidence work.
+- Use `docs/...` when the task only adds or edits Markdown documentation.
+- Choose a short, descriptive branch name that matches the task scope.
+
+## Engineering Rules
+
+- Keep the library consumer-agnostic. Public APIs, runtime code, tests, examples, and canonical documentation must model generic chart and data primitives rather than application-specific product domains; consumer semantics belong outside this repository.
+- All configurable/default values in the Python layer must be centralized under `src/fastplotpy/defaults.py` and `src/fastplotpy/defaults_data`.
+- Avoid introducing new inline visual/behavior defaults in runtime code (`renderers`, `core`), including alpha/width/size/font-style constants.
+- When adding feature options, add or update the matching defaults file first, then consume those defaults from runtime code.
+- Preserve user changes. Do not revert unrelated work.

fastplotpy-0.3.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Intellisys Software
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fastplotpy-0.3.0a1/MANIFEST.in

@@ -0,0 +1,14 @@
+recursive-include rust *.rs *.toml
+recursive-include rust *.ttf
+include rust/Cargo.lock
+include AGENTS.md README.md LICENSE charting_library_spec_en.md
+recursive-include docs *.md *.png
+recursive-include bench *.md
+recursive-include src/fastplotpy *.md *.txt
+recursive-include examples *.ipynb
+recursive-include examples/gallery *.py *.js *.css *.html *.json
+recursive-include tests *.py *.json
+recursive-include tools *.py
+prune rust/target
+prune build
+prune dist

fastplotpy-0.3.0a1/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: fastplotpy
+Version: 0.3.0a1
+Summary: Python port of fastPlotJs chart scenes and interactive charts
+Author: Intellisys Software
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: notebook
+Requires-Dist: ipython>=8; extra == "notebook"
+Requires-Dist: ipywidgets>=8; extra == "notebook"
+Provides-Extra: test
+Requires-Dist: Pillow>=10; extra == "test"
+Dynamic: license-file
+
+# FastPlotPy
+
+FastPlotPy is the Python port of FastPlotJs for renderer-neutral scene generation and browser/Jupyter charts. After its first PyPI publication, install with:
+
+```sh
+python -m pip install fastplotpy
+```
+
+In Python or Jupyter:
+
+```python
+from fastplotpy import createChart
+
+chart = createChart({
+    "type": "line",
+    "width": 800,
+    "height": 400,
+    "engine": "auto",
+    "data": [{"x": 0, "y": 12}, {"x": 1, "y": 18}],
+    "axes": {"show": True},
+})
+chart  # Jupyter displays the interactive browser view.
+```
+
+The local chart view uses the pinned FastPlotJs browser frontend for Canvas,
+pointer, and WebGL behavior. Its loopback bridge binds to `127.0.0.1` for the
+chart session. Python owns scene and state APIs; source frontend callbacks can
+invoke Python formatters. Browser WebAssembly is separate from the optional
+Python-host Rust core and is not initialized by `initWasmPlotEngine()` in CPython.
+The source-named `hasNodePlotEngine()` and `initNodePlotEngine()` are Python
+compatibility aliases for `hasRustPlotEngine()` and `initRustPlotEngine()`;
+they do not start or require Node.js. `getRustPlotEngineStatus()` reports host
+native capabilities. `getWasmPlotEngineStatus()` reports CPython availability,
+not the state of the separate browser frontend.
+
+Without a browser, `plot()` produces a renderer-neutral scene:
+
+```python
+from fastplotpy import plot
+
+scene = plot({
+    "type": "line",
+    "width": 800,
+    "height": 400,
+    "engine": "ts",  # Source spelling selects the Python fallback geometry.
+    "data": [{"x": 0, "y": 12}, {"x": 1, "y": 18}],
+})
+```
+
+Current Python geometry covers all eleven source chart families, including
+source-documented 3D LOD, encodings, lighting, accessibility, and multiple
+subplots. No chart calculation invokes Node.js at package runtime. Strict
+`engine="rust"` uses the optional pinned Rust core
+for supported 2D families and fails explicitly when unavailable. Pie3D reuses
+`pie` datum and presentation options, accepts `pie3d.extrusionDepth` in
+`(0, 1]`, and uses the shared `scene3d.camera`. The native 3D PNG path has
+Windows validation only. `renderToPNG()` retains the source placeholder behavior.
+
+The source project is [FastPlotJs](https://fastplotjs.com). The first Python
+alpha candidate is `0.3.0a1`; check PyPI separately for publication status.
+Python 3.11 or newer is required. Its Windows wheel includes Python code,
+the pinned frontend,
+the built Rust ABI library, and the MIT License. The source
+distribution includes the pinned Rust sources and lockfile for optional
+native builds. Bundled font attribution is in the packaged
+`assets/native/THIRD_PARTY_NOTICES.md` file.
+
+## Canvas quality
+
+The pinned browser frontend accepts `canvas: { pixelRatio: "auto", resolutionScale: 2 }` through `createChart`. Omitted ratios default to `1`; logical sizes, text, and pointer coordinates remain unchanged while the backing bitmap scales. Experimental Pie3D also accepts `pie3d: { curveTolerance: 0.1 }` (default `1` logical pixel; smaller means more faces, within `scene3d.maxPoints`). Higher settings use more memory and rendering work. The source browser comparison remains in FastPlotJs. The Python source distribution includes the local Python-backed gallery under `examples/gallery/`; the installed wheel bundles the interactive frontend but does not install the standalone gallery server.