graphunslopify 0.8.0__tar.gz

graphunslopify-0.8.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GraphUnslopify contributors
+
+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.

graphunslopify-0.8.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: graphunslopify
+Version: 0.8.0
+Summary: Local semantic figure generation and render-time scientific figure checks.
+License-Expression: MIT
+Project-URL: Homepage, https://unluckyjet.github.io/GraphUnslopify/
+Project-URL: Source, https://github.com/unluckyjet/GraphUnslopify
+Project-URL: Documentation, https://github.com/unluckyjet/GraphUnslopify/tree/v0.8.0/docs
+Project-URL: Changelog, https://github.com/unluckyjet/GraphUnslopify/releases/tag/v0.8.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: matplotlib>=3.9
+Requires-Dist: pandas>=2.0
+Requires-Dist: numpy>=1.24
+Requires-Dist: pypdf>=5
+Requires-Dist: typing_extensions>=4.4
+Requires-Dist: nodejs-wheel-binaries<25,>=22.13.1
+Requires-Dist: jsonschema>=4
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: jsonschema>=4; extra == "dev"
+Provides-Extra: interactive
+Requires-Dist: plotly>=5.24; extra == "interactive"
+Provides-Extra: parquet
+Requires-Dist: pyarrow>=15; extra == "parquet"
+Provides-Extra: pdf
+Requires-Dist: pypdfium2<6,>=4.30; extra == "pdf"
+Provides-Extra: statistics
+Requires-Dist: scipy>=1.11; extra == "statistics"
+Provides-Extra: notebook
+Requires-Dist: jupyterlab>=4; extra == "notebook"
+Requires-Dist: ipykernel>=6.29; extra == "notebook"
+Requires-Dist: nbclient>=0.10; extra == "notebook"
+Provides-Extra: agent
+Requires-Dist: mcp<3,>=2.3; extra == "agent"
+Dynamic: license-file
+
+# GraphUnslopify
+
+Translate semantic JSON into reviewable Python figures, render local data, and check claims,
+readability and accessibility. The package includes the TypeScript translator and a Node runtime;
+translation and rendering need no hosted service after installation.
+
+In a Python 3.10+ virtual environment:
+
+```sh
+python -m pip install "https://github.com/unluckyjet/GraphUnslopify/releases/download/v0.8.0/graphunslopify-0.8.0-py3-none-any.whl"
+```
+
+From a source checkout, `python -m pip install ./python` remains supported.
+
+```sh
+graphunslopify doctor
+graphunslopify demo
+graphunslopify render graphunslopify-demo/figure.json --strict --json
+```
+
+The demo creates public synthetic CSV data and PNG/SVG/PDF figures, a standalone Python program,
+and a JSON verification report. Data paths in a JSON spec resolve beside the spec file.
+`graphunslopify translate figure.json --output figure.py` emits code without rendering.
+
+`graphunslopify preview --open` launches the packaged offline browser editor. Choose data, edit a
+spec or recipe, review live strict previews and apply an offered fix. Download figures, Python,
+spec and report together; input data enters the ZIP only when explicitly selected.
+See [the local editor workflow](../docs/local-editor.md), including VS Code's integrated terminal.
+
+```python
+from graphunslopify import Figure
+
+Figure.line("results.csv").x("epoch", "Epoch").y("score", "Score").render(strict=True)
+```
+
+`Figure.translate()` and `Figure.from_profile()` default to the packaged local translator.
+Select a hosted translator explicitly with `api="https://your-service"` or
+`GRAPHUNSLOPIFY_API`; use `api="local"` to override that environment setting.
+`GRAPHUNSLOPIFY_NODE` can select a specific Node executable.
+
+Current development source enables strict verification by default in `Figure.render()` and
+execution commands. Explicit `strict=False` / `--no-strict` opts out while retaining failed or
+incomplete report verdicts; warning rejection always implies strict mode. The pinned0.8.0 wheel uses these defaults. Older 0.7.0 installs require `strict=True` / `--strict`.
+
+Use `[interactive]` for supported self-contained Plotly HTML. Strict verification rejects failed
+or untested required checks; literal data claims are not statistical significance tests.
+Read the repository documentation for the supported combinations and limits.
+
+## What it checks
+
+`text_too_small` and `text_near_minimum` measure every text element at the width the figure will
+occupy on the page. Generated programs measure their written PNG/SVG/PDF widths, including
+tight cropping and padding, before calculating manuscript scaling. For your own figure, pass
+`target_width_in` and `export_paths=["figure.pdf"]` after saving; without paths the API uses the
+nominal canvas. Reports retain the measured widths and scale. See
+[the measurement contract and limits](../docs/export-legibility.md).
+
+`tick_labels_collide` compares neighbouring tick label bounding boxes. `legend_covers_data` counts
+plotted points falling inside the legend box. `overplotting` measures marker ink against plotting
+area.
+
+`series_indistinguishable` measures CIEDE2000 between every pair of legend colours as composited
+over white, then repeats it under simulated protanopia, deuteranopia and tritanopia.
+`greyscale_collision` catches pairs that survive colour but merge in a black and white print, and
+stays quiet when a second channel such as line style or marker already separates them.
+
+`truncated_bar_axis` is an error, because a bar's length encodes its value. `axis_exaggeration`
+warns when a line axis is zoomed so far that a rounding error fills the frame.
+
+Every check is geometric or colorimetric. Nothing asks a model for an opinion, so the same figure
+always yields the same findings. Reasoning and sources are in [research notes](https://github.com/unluckyjet/GraphUnslopify/blob/v0.8.0/docs/research.md).
+
+
+[Source](https://github.com/unluckyjet/GraphUnslopify) · [Versioned 0.8.0 documentation](https://github.com/unluckyjet/GraphUnslopify/tree/v0.8.0/docs) · [Release assets](https://github.com/unluckyjet/GraphUnslopify/releases/tag/v0.8.0).
+MIT license. The bundled translator includes Zod's MIT license; runtime/dependency licenses ship
+with their respective Python distributions.
+
+## Paper audits
+
+`graphunslopify audit paper/ --out-dir audit-output` regenerates all figures in the directory’s
+`graphunslopify.json` manifest with strict verification. `--baseline previous/audit.report.json`
+adds data, numeric-representation, claim, description and artifact differences. It writes aggregate
+JSON/Markdown plus individual programs, figures, logs and reports. See the repository paper-audit
+guide for the manifest contract and supported metadata-backed artifact checks.
+
+## Notebook example
+
+Install the notebook extra for JupyterLab and kernel execution. Run
+`graphunslopify notebook --output quickstart.ipynb`, then `jupyter lab quickstart.ipynb`, or add
+`--execute` to run it through the current Python environment. All 21 figure kinds have named
+Python constructors and a shared Kind typing Literal. See the repository notebook guide.
+
+## Local MCP server
+
+Install the agent extra, then run `graphunslopify mcp-config` (or `--client codex`) to print a
+configuration for the current environment. The host launches `graphunslopify mcp` over stdio.
+Seven read-only compiler tools share the canonical emitter; data profiling/rendering remain local
+CLI operations. See the repository agent guide for setup, error semantics and protocol tests.

graphunslopify-0.8.0/README.md

@@ -0,0 +1,98 @@
+# GraphUnslopify
+
+Translate semantic JSON into reviewable Python figures, render local data, and check claims,
+readability and accessibility. The package includes the TypeScript translator and a Node runtime;
+translation and rendering need no hosted service after installation.
+
+In a Python 3.10+ virtual environment:
+
+```sh
+python -m pip install "https://github.com/unluckyjet/GraphUnslopify/releases/download/v0.8.0/graphunslopify-0.8.0-py3-none-any.whl"
+```
+
+From a source checkout, `python -m pip install ./python` remains supported.
+
+```sh
+graphunslopify doctor
+graphunslopify demo
+graphunslopify render graphunslopify-demo/figure.json --strict --json
+```
+
+The demo creates public synthetic CSV data and PNG/SVG/PDF figures, a standalone Python program,
+and a JSON verification report. Data paths in a JSON spec resolve beside the spec file.
+`graphunslopify translate figure.json --output figure.py` emits code without rendering.
+
+`graphunslopify preview --open` launches the packaged offline browser editor. Choose data, edit a
+spec or recipe, review live strict previews and apply an offered fix. Download figures, Python,
+spec and report together; input data enters the ZIP only when explicitly selected.
+See [the local editor workflow](../docs/local-editor.md), including VS Code's integrated terminal.
+
+```python
+from graphunslopify import Figure
+
+Figure.line("results.csv").x("epoch", "Epoch").y("score", "Score").render(strict=True)
+```
+
+`Figure.translate()` and `Figure.from_profile()` default to the packaged local translator.
+Select a hosted translator explicitly with `api="https://your-service"` or
+`GRAPHUNSLOPIFY_API`; use `api="local"` to override that environment setting.
+`GRAPHUNSLOPIFY_NODE` can select a specific Node executable.
+
+Current development source enables strict verification by default in `Figure.render()` and
+execution commands. Explicit `strict=False` / `--no-strict` opts out while retaining failed or
+incomplete report verdicts; warning rejection always implies strict mode. The pinned0.8.0 wheel uses these defaults. Older 0.7.0 installs require `strict=True` / `--strict`.
+
+Use `[interactive]` for supported self-contained Plotly HTML. Strict verification rejects failed
+or untested required checks; literal data claims are not statistical significance tests.
+Read the repository documentation for the supported combinations and limits.
+
+## What it checks
+
+`text_too_small` and `text_near_minimum` measure every text element at the width the figure will
+occupy on the page. Generated programs measure their written PNG/SVG/PDF widths, including
+tight cropping and padding, before calculating manuscript scaling. For your own figure, pass
+`target_width_in` and `export_paths=["figure.pdf"]` after saving; without paths the API uses the
+nominal canvas. Reports retain the measured widths and scale. See
+[the measurement contract and limits](../docs/export-legibility.md).
+
+`tick_labels_collide` compares neighbouring tick label bounding boxes. `legend_covers_data` counts
+plotted points falling inside the legend box. `overplotting` measures marker ink against plotting
+area.
+
+`series_indistinguishable` measures CIEDE2000 between every pair of legend colours as composited
+over white, then repeats it under simulated protanopia, deuteranopia and tritanopia.
+`greyscale_collision` catches pairs that survive colour but merge in a black and white print, and
+stays quiet when a second channel such as line style or marker already separates them.
+
+`truncated_bar_axis` is an error, because a bar's length encodes its value. `axis_exaggeration`
+warns when a line axis is zoomed so far that a rounding error fills the frame.
+
+Every check is geometric or colorimetric. Nothing asks a model for an opinion, so the same figure
+always yields the same findings. Reasoning and sources are in [research notes](https://github.com/unluckyjet/GraphUnslopify/blob/v0.8.0/docs/research.md).
+
+
+[Source](https://github.com/unluckyjet/GraphUnslopify) · [Versioned 0.8.0 documentation](https://github.com/unluckyjet/GraphUnslopify/tree/v0.8.0/docs) · [Release assets](https://github.com/unluckyjet/GraphUnslopify/releases/tag/v0.8.0).
+MIT license. The bundled translator includes Zod's MIT license; runtime/dependency licenses ship
+with their respective Python distributions.
+
+## Paper audits
+
+`graphunslopify audit paper/ --out-dir audit-output` regenerates all figures in the directory’s
+`graphunslopify.json` manifest with strict verification. `--baseline previous/audit.report.json`
+adds data, numeric-representation, claim, description and artifact differences. It writes aggregate
+JSON/Markdown plus individual programs, figures, logs and reports. See the repository paper-audit
+guide for the manifest contract and supported metadata-backed artifact checks.
+
+## Notebook example
+
+Install the notebook extra for JupyterLab and kernel execution. Run
+`graphunslopify notebook --output quickstart.ipynb`, then `jupyter lab quickstart.ipynb`, or add
+`--execute` to run it through the current Python environment. All 21 figure kinds have named
+Python constructors and a shared Kind typing Literal. See the repository notebook guide.
+
+## Local MCP server
+
+Install the agent extra, then run `graphunslopify mcp-config` (or `--client codex`) to print a
+configuration for the current environment. The host launches `graphunslopify mcp` over stdio.
+Seven read-only compiler tools share the canonical emitter; data profiling/rendering remain local
+CLI operations. See the repository agent guide for setup, error semantics and protocol tests.

graphunslopify-0.8.0/graphunslopify/ZOD-LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+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.

graphunslopify-0.8.0/graphunslopify/__init__.py

@@ -0,0 +1,36 @@
+"""Render-time checks for figures produced by GraphUnslopify.
+
+The MCP server checks a spec. This checks the picture. Import it in a generated
+script and it reports what a reviewer would complain about, before you submit.
+
+    from graphunslopify import inspect_figure
+
+    report = inspect_figure(fig, target_width_in=3.4)
+    print(report)
+"""
+
+from .build import Figure, Kind, SpecError
+from .colour import ciede2000, distance, simulate, worst_case_distance
+from .describe import profile
+from .inspect import Finding, Report, inspect_figure
+from .lockfile import appearance
+from .provenance import ProvenanceError, read_provenance
+
+__all__ = [
+    "Figure",
+    "Finding",
+    "Kind",
+    "ProvenanceError",
+    "Report",
+    "SpecError",
+    "appearance",
+    "ciede2000",
+    "distance",
+    "inspect_figure",
+    "profile",
+    "read_provenance",
+    "simulate",
+    "worst_case_distance",
+]
+
+__version__ = "0.8.0"