figfoundry 0.1.0__tar.gz → 0.2.0__tar.gz

figfoundry-0.2.0/PKG-INFO

@@ -0,0 +1,261 @@
+Metadata-Version: 2.5
+Name: figfoundry
+Version: 0.2.0
+Summary: WYSIWYG matplotlib figure composer: load data (.npz/.pkl), drag signals onto a canvas to build plots, and export clean reproducible code.
+Project-URL: Homepage, https://github.com/ductai199x/figfoundry
+Project-URL: Repository, https://github.com/ductai199x/figfoundry
+Project-URL: Issues, https://github.com/ductai199x/figfoundry/issues
+Author-email: Tai Duc Nguyen <taiducnguyen.drexel@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: data-visualization,figures,matplotlib,plotting,scientific-figures,wysiwyg
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.10
+Requires-Dist: fastapi>=0.110
+Requires-Dist: matplotlib>=3.9
+Requires-Dist: numpy>=1.24
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: uvicorn>=0.29
+Provides-Extra: dev
+Requires-Dist: httpx2>=2.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="media/logo.svg" width="88" alt="Fig Foundry">
+</p>
+
+<h1 align="center">Fig Foundry</h1>
+
+<p align="center">
+  <b>A WYSIWYG figure studio for matplotlib.</b><br>
+  Drag your data onto a free canvas, compose publication figures, and export the
+  exact Python that draws them. The preview is the generated code, executed — so
+  what you see is what the <code>.py</code> produces.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/figfoundry/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/figfoundry?color=2f6690"></a>
+  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-2f6690"></a>
+  <img alt="Python 3.10 and newer" src="https://img.shields.io/badge/python-3.10+-2f6690">
+  <img alt="Runs on Windows, macOS and Linux" src="https://img.shields.io/badge/platforms-Windows%20%7C%20macOS%20%7C%20Linux-2f6690">
+</p>
+
+<p align="center">
+  <a href="#install"><b>Install</b></a> ·
+  <a href="#a-quick-tour">Tour</a> ·
+  <a href="#measured-not-claimed">Measured</a> ·
+  <a href="#how-it-works">How it works</a> ·
+  <a href="#command-line">Command line</a>
+</p>
+
+<p align="center">
+  <img src="media/hero.png" width="880" alt="The canvas: a nine-panel autocorrelation figure composed from the signals of one dataset, with the signal library on the left and a per-plot inspector on the right.">
+</p>
+<p align="center">
+  <sub>A nine-panel figure composed on the canvas from one dataset's signals. Every panel
+  is a real matplotlib <code>Axes</code> placed by explicit coordinates, so it can sit
+  anywhere, at any size.</sub>
+</p>
+
+You have the data; Fig Foundry is the table you lay it out on. Load a dataset, drag a
+signal onto the canvas and it becomes a plot. Move and resize plots with snapping, nudge
+and style each one in the inspector, add the second series or the σ-band, and when it is
+right, export the code. Because the preview is rendered by running that very code, there is
+no "close enough" — the figure you arrange and the script you ship are the same drawing.
+
+<table>
+  <tr>
+    <td width="50%" valign="top">
+      <b>WYSIWYG by construction</b><br>
+      One drawing path. The browser preview executes the generated <code>.py</code>, so the
+      export is byte-for-byte what you see. There is no second renderer to drift.
+    </td>
+    <td width="50%" valign="top">
+      <b>The atom is data</b><br>
+      A figure is a scene of plots over named signals. Drag a signal to make a plot; drop it
+      on one to overlay a line, a σ-band, or error bars. Nothing is hand-drawn.
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" valign="top">
+      <b>Twenty-three plot types</b><br>
+      Line, step, scatter, grouped scatter, bar, box, violin, histograms, hexbin, image,
+      contour, pcolormesh, vector fields, streamplot, decision boundary, pie, polar, and
+      three 3-D types.
+    </td>
+    <td width="50%" valign="top">
+      <b>Private, on your machine</b><br>
+      A local web app. Your datasets, figures and exports live in <code>~/.figfoundry</code>;
+      nothing you load is sent anywhere. Pickle files load through a whitelist, not a
+      deserializer.
+    </td>
+  </tr>
+</table>
+
+## A quick tour
+
+<p align="center">
+  <img src="media/dark.png" width="880" alt="The same nine-panel figure with the interface in dark mode: dark chrome around a white artboard.">
+</p>
+<p align="center"><b>Light, dark, or your system's.</b> The interface re-skins; the figure
+itself stays on a white artboard, so the artwork is publication-clean in either theme.</p>
+
+<p align="center">
+  <img src="media/viewfinder.png" width="620" alt="The 3-D viewfinder: a surface plot with elevation, azimuth and zoom controls, and invert toggles for rotate and zoom.">
+</p>
+<p align="center"><b>3-D, to your angle.</b> Double-click a 3-D plot to open the viewfinder:
+drag to rotate, scroll to zoom, or use the sliders. Accept writes the camera back to the
+figure and, with it, into the exported code.</p>
+
+<table>
+  <tr>
+    <td width="50%" valign="top">
+      <img src="media/export.png" width="420" alt="The export dialog: the generated Python, with PNG, SVG and PDF figure buttons and a download.">
+      <p><b>Export the code and the figure.</b> The standalone <code>.py</code>, plus the
+      figure as PNG, SVG or PDF — SVG and PDF are vector, for the paper.</p>
+    </td>
+    <td width="50%" valign="top">
+      <img src="media/picker.png" width="420" alt="The picker: a New figure card and your saved figures, each with a live thumbnail.">
+      <p><b>Your figures.</b> Every canvas is saved with a live thumbnail; open, duplicate
+      or delete from here. Each one is tied to the dataset it was built from.</p>
+    </td>
+  </tr>
+</table>
+
+## Measured, not claimed
+
+Every figure below is reproducible from the repository: the test suite, the CI runs, and the
+security probes.
+
+| | |
+|---|---|
+| Plot types, each verified preview-identical to its export | **23 of 23** ([tests](tests/test_plot_types.py)) |
+| Tests, passing on Linux and Windows, Python 3.10 and 3.12 | **152** ([CI](https://github.com/ductai199x/figfoundry/actions)) |
+| Malicious pickle payloads the whitelist refuses to load | **18**, including `np.fromfile`, `np.load`, `__import__`, `eval`, `exec` ([tests](tests/test_data_app.py)) |
+| Separate renderers the export can drift from | **0** — the preview executes the export |
+
+## What it does
+
+- **Composes on a free canvas.** Plots are explicit rectangles, not a fixed grid, so they
+  go anywhere and at any size. Move, resize with snapping, nudge with the arrow keys, and
+  multi-select (Shift+click) to move, nudge or delete a group at once.
+- **Twenty-three plot types.** Line, step, scatter, grouped scatter (color-by-class), bar and
+  horizontal bar, histogram, box plot, violin plot, 2-D histogram, hexbin, image, contour
+  (filled and lines), pcolormesh, vector field, streamplot, decision boundary (a surface with
+  the points on top), pie, polar, 3-D scatter, 3-D surface and 3-D wireframe.
+- **Styles every element.** Per plot: the data, plot type, color, line and marker, σ-band and
+  error bars, ticks and tick labels, limits and scale, spines, title, colormap and colorbar,
+  and artists — vertical and horizontal lines, text, annotations, arrows, boxes, circles,
+  ellipses, polygons and legends. Figure-level axis labels, legend, suptitle and free text.
+- **Suggests accessible color.** One click applies the colorblind-safe Okabe–Ito palette to a
+  plot's series; a palette menu (Okabe–Ito, Bright, Viridis, Plasma, Cividis) is available
+  through the API.
+- **Speaks LaTeX.** Labels, titles and text take mathtext, so `$x_0$` and `$\alpha$` render.
+- **Lays out for you.** Arrange in a grid, align and distribute a selection, set margins and
+  gaps, and sync axis ranges across every plot at once.
+- **Exports clean code.** The figure as a standalone <code>.py</code> that references the
+  dataset, plus the rendered figure as PNG, SVG or PDF. The 3-D camera, the colors, the
+  ticks — all of it is in the code.
+- **Remembers your setup.** Themes, and the 3-D rotate/zoom direction, persist; figures,
+  datasets and exports live in <code>~/.figfoundry</code>.
+
+## How it works
+
+```mermaid
+flowchart LR
+    data(["Your data<br/>.npz / .pkl / .csv"]) --> spec["The spec<br/>a scene: canvas,<br/>plots, artists"]
+    spec --> code["codegen<br/>a standalone .py"]
+    code --> run["execute the .py"]
+    run --> view(["Preview<br/>(what you see)"])
+    code --> out(["Export<br/>.py + PNG / SVG / PDF"])
+```
+
+- **One path, both ends.** `codegen_canvas` turns the spec into a plain <code>.py</code> — a
+  list of <code>fig.add_axes([...])</code> calls over the dataset. The preview is that file,
+  run; the export is that file, saved. They cannot disagree, because they are the same code.
+- **The spec is the source of truth.** A figure is a JSON scene (canvas, plots, artists). The
+  browser edits it; the backend renders it by executing the generated code. Save it and it is
+  a canvas you can reopen, duplicate and drive over the API.
+- **Data stays data.** Signals are arrays, referenced by name. The exported code loads the
+  dataset and indexes it — the numbers in the figure are the numbers in your file, unedited.
+
+## Data
+
+A *dataset* is a named set of signals (arrays), 1-D and 2-D. Load one with **Load data…**
+(pick an existing dataset, or upload a file):
+
+- **`.npz`** — a numpy zip of named arrays. Safe by construction.
+- **`.pkl`** — a Python pickle, loaded through a **whitelist unpickler** that permits only
+  numpy arrays and plain containers. A pickle that tries to run code — `os`, `subprocess`,
+  `eval`, `np.fromfile` and the rest — is refused, not executed.
+- **`.csv`** — a table with a header row; each numeric column becomes a signal.
+
+## Command line
+
+The same engines run from the shell, for scripting and automation:
+
+```
+figfoundry            # start the web app (default)
+figfoundry serve      # ...with flags: --port, --host, --no-browser
+figfoundry list       # list saved figures
+figfoundry new        # create a blank figure, print its slug
+figfoundry export SLUG [--out PATH]        # write a figure's .py
+figfoundry render SLUG [--format png|svg|pdf] [--out PATH]
+figfoundry datasets   # list available datasets
+```
+
+## Install
+
+From [PyPI](https://pypi.org/project/figfoundry/), with [uv](https://docs.astral.sh/uv/):
+
+```sh
+uv tool install figfoundry      # puts the `figfoundry` command on your PATH
+figfoundry                      # → opens http://127.0.0.1:8037
+```
+
+Or:
+
+```sh
+pip install figfoundry
+# or from this repository:
+uv tool install figfoundry --from "git+https://github.com/ductai199x/figfoundry.git"
+```
+
+Python 3.10 or newer. It runs wherever Python and a browser do.
+
+<details>
+<summary>Development</summary>
+
+```sh
+uv sync --extra dev
+uv run --extra dev pytest -q          # 152 tests
+uv run --with ruff ruff check .       # lint
+uv run figfoundry serve               # the app
+```
+
+The suite covers the WYSIWYG invariant for every plot type, the pickle whitelist, dataset I/O
+(npz/pkl/csv), vector export, the CLI, and the API through a test client. CI runs it, plus the
+build and an artifact check, on Linux and Windows for Python 3.10 and 3.12
+([.github/workflows/ci.yml](.github/workflows/ci.yml)).
+
+</details>
+
+## License
+
+Copyright (C) 2026 Tai Duc Nguyen.
+
+Fig Foundry is licensed under the [MIT License](LICENSE): use it, study it, change it and
+share it. The one sample dataset it ships is synthetic; your own data never leaves your
+machine.

figfoundry-0.2.0/README.md

@@ -0,0 +1,227 @@
+<p align="center">
+  <img src="media/logo.svg" width="88" alt="Fig Foundry">
+</p>
+
+<h1 align="center">Fig Foundry</h1>
+
+<p align="center">
+  <b>A WYSIWYG figure studio for matplotlib.</b><br>
+  Drag your data onto a free canvas, compose publication figures, and export the
+  exact Python that draws them. The preview is the generated code, executed — so
+  what you see is what the <code>.py</code> produces.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/figfoundry/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/figfoundry?color=2f6690"></a>
+  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-2f6690"></a>
+  <img alt="Python 3.10 and newer" src="https://img.shields.io/badge/python-3.10+-2f6690">
+  <img alt="Runs on Windows, macOS and Linux" src="https://img.shields.io/badge/platforms-Windows%20%7C%20macOS%20%7C%20Linux-2f6690">
+</p>
+
+<p align="center">
+  <a href="#install"><b>Install</b></a> ·
+  <a href="#a-quick-tour">Tour</a> ·
+  <a href="#measured-not-claimed">Measured</a> ·
+  <a href="#how-it-works">How it works</a> ·
+  <a href="#command-line">Command line</a>
+</p>
+
+<p align="center">
+  <img src="media/hero.png" width="880" alt="The canvas: a nine-panel autocorrelation figure composed from the signals of one dataset, with the signal library on the left and a per-plot inspector on the right.">
+</p>
+<p align="center">
+  <sub>A nine-panel figure composed on the canvas from one dataset's signals. Every panel
+  is a real matplotlib <code>Axes</code> placed by explicit coordinates, so it can sit
+  anywhere, at any size.</sub>
+</p>
+
+You have the data; Fig Foundry is the table you lay it out on. Load a dataset, drag a
+signal onto the canvas and it becomes a plot. Move and resize plots with snapping, nudge
+and style each one in the inspector, add the second series or the σ-band, and when it is
+right, export the code. Because the preview is rendered by running that very code, there is
+no "close enough" — the figure you arrange and the script you ship are the same drawing.
+
+<table>
+  <tr>
+    <td width="50%" valign="top">
+      <b>WYSIWYG by construction</b><br>
+      One drawing path. The browser preview executes the generated <code>.py</code>, so the
+      export is byte-for-byte what you see. There is no second renderer to drift.
+    </td>
+    <td width="50%" valign="top">
+      <b>The atom is data</b><br>
+      A figure is a scene of plots over named signals. Drag a signal to make a plot; drop it
+      on one to overlay a line, a σ-band, or error bars. Nothing is hand-drawn.
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" valign="top">
+      <b>Twenty-three plot types</b><br>
+      Line, step, scatter, grouped scatter, bar, box, violin, histograms, hexbin, image,
+      contour, pcolormesh, vector fields, streamplot, decision boundary, pie, polar, and
+      three 3-D types.
+    </td>
+    <td width="50%" valign="top">
+      <b>Private, on your machine</b><br>
+      A local web app. Your datasets, figures and exports live in <code>~/.figfoundry</code>;
+      nothing you load is sent anywhere. Pickle files load through a whitelist, not a
+      deserializer.
+    </td>
+  </tr>
+</table>
+
+## A quick tour
+
+<p align="center">
+  <img src="media/dark.png" width="880" alt="The same nine-panel figure with the interface in dark mode: dark chrome around a white artboard.">
+</p>
+<p align="center"><b>Light, dark, or your system's.</b> The interface re-skins; the figure
+itself stays on a white artboard, so the artwork is publication-clean in either theme.</p>
+
+<p align="center">
+  <img src="media/viewfinder.png" width="620" alt="The 3-D viewfinder: a surface plot with elevation, azimuth and zoom controls, and invert toggles for rotate and zoom.">
+</p>
+<p align="center"><b>3-D, to your angle.</b> Double-click a 3-D plot to open the viewfinder:
+drag to rotate, scroll to zoom, or use the sliders. Accept writes the camera back to the
+figure and, with it, into the exported code.</p>
+
+<table>
+  <tr>
+    <td width="50%" valign="top">
+      <img src="media/export.png" width="420" alt="The export dialog: the generated Python, with PNG, SVG and PDF figure buttons and a download.">
+      <p><b>Export the code and the figure.</b> The standalone <code>.py</code>, plus the
+      figure as PNG, SVG or PDF — SVG and PDF are vector, for the paper.</p>
+    </td>
+    <td width="50%" valign="top">
+      <img src="media/picker.png" width="420" alt="The picker: a New figure card and your saved figures, each with a live thumbnail.">
+      <p><b>Your figures.</b> Every canvas is saved with a live thumbnail; open, duplicate
+      or delete from here. Each one is tied to the dataset it was built from.</p>
+    </td>
+  </tr>
+</table>
+
+## Measured, not claimed
+
+Every figure below is reproducible from the repository: the test suite, the CI runs, and the
+security probes.
+
+| | |
+|---|---|
+| Plot types, each verified preview-identical to its export | **23 of 23** ([tests](tests/test_plot_types.py)) |
+| Tests, passing on Linux and Windows, Python 3.10 and 3.12 | **152** ([CI](https://github.com/ductai199x/figfoundry/actions)) |
+| Malicious pickle payloads the whitelist refuses to load | **18**, including `np.fromfile`, `np.load`, `__import__`, `eval`, `exec` ([tests](tests/test_data_app.py)) |
+| Separate renderers the export can drift from | **0** — the preview executes the export |
+
+## What it does
+
+- **Composes on a free canvas.** Plots are explicit rectangles, not a fixed grid, so they
+  go anywhere and at any size. Move, resize with snapping, nudge with the arrow keys, and
+  multi-select (Shift+click) to move, nudge or delete a group at once.
+- **Twenty-three plot types.** Line, step, scatter, grouped scatter (color-by-class), bar and
+  horizontal bar, histogram, box plot, violin plot, 2-D histogram, hexbin, image, contour
+  (filled and lines), pcolormesh, vector field, streamplot, decision boundary (a surface with
+  the points on top), pie, polar, 3-D scatter, 3-D surface and 3-D wireframe.
+- **Styles every element.** Per plot: the data, plot type, color, line and marker, σ-band and
+  error bars, ticks and tick labels, limits and scale, spines, title, colormap and colorbar,
+  and artists — vertical and horizontal lines, text, annotations, arrows, boxes, circles,
+  ellipses, polygons and legends. Figure-level axis labels, legend, suptitle and free text.
+- **Suggests accessible color.** One click applies the colorblind-safe Okabe–Ito palette to a
+  plot's series; a palette menu (Okabe–Ito, Bright, Viridis, Plasma, Cividis) is available
+  through the API.
+- **Speaks LaTeX.** Labels, titles and text take mathtext, so `$x_0$` and `$\alpha$` render.
+- **Lays out for you.** Arrange in a grid, align and distribute a selection, set margins and
+  gaps, and sync axis ranges across every plot at once.
+- **Exports clean code.** The figure as a standalone <code>.py</code> that references the
+  dataset, plus the rendered figure as PNG, SVG or PDF. The 3-D camera, the colors, the
+  ticks — all of it is in the code.
+- **Remembers your setup.** Themes, and the 3-D rotate/zoom direction, persist; figures,
+  datasets and exports live in <code>~/.figfoundry</code>.
+
+## How it works
+
+```mermaid
+flowchart LR
+    data(["Your data<br/>.npz / .pkl / .csv"]) --> spec["The spec<br/>a scene: canvas,<br/>plots, artists"]
+    spec --> code["codegen<br/>a standalone .py"]
+    code --> run["execute the .py"]
+    run --> view(["Preview<br/>(what you see)"])
+    code --> out(["Export<br/>.py + PNG / SVG / PDF"])
+```
+
+- **One path, both ends.** `codegen_canvas` turns the spec into a plain <code>.py</code> — a
+  list of <code>fig.add_axes([...])</code> calls over the dataset. The preview is that file,
+  run; the export is that file, saved. They cannot disagree, because they are the same code.
+- **The spec is the source of truth.** A figure is a JSON scene (canvas, plots, artists). The
+  browser edits it; the backend renders it by executing the generated code. Save it and it is
+  a canvas you can reopen, duplicate and drive over the API.
+- **Data stays data.** Signals are arrays, referenced by name. The exported code loads the
+  dataset and indexes it — the numbers in the figure are the numbers in your file, unedited.
+
+## Data
+
+A *dataset* is a named set of signals (arrays), 1-D and 2-D. Load one with **Load data…**
+(pick an existing dataset, or upload a file):
+
+- **`.npz`** — a numpy zip of named arrays. Safe by construction.
+- **`.pkl`** — a Python pickle, loaded through a **whitelist unpickler** that permits only
+  numpy arrays and plain containers. A pickle that tries to run code — `os`, `subprocess`,
+  `eval`, `np.fromfile` and the rest — is refused, not executed.
+- **`.csv`** — a table with a header row; each numeric column becomes a signal.
+
+## Command line
+
+The same engines run from the shell, for scripting and automation:
+
+```
+figfoundry            # start the web app (default)
+figfoundry serve      # ...with flags: --port, --host, --no-browser
+figfoundry list       # list saved figures
+figfoundry new        # create a blank figure, print its slug
+figfoundry export SLUG [--out PATH]        # write a figure's .py
+figfoundry render SLUG [--format png|svg|pdf] [--out PATH]
+figfoundry datasets   # list available datasets
+```
+
+## Install
+
+From [PyPI](https://pypi.org/project/figfoundry/), with [uv](https://docs.astral.sh/uv/):
+
+```sh
+uv tool install figfoundry      # puts the `figfoundry` command on your PATH
+figfoundry                      # → opens http://127.0.0.1:8037
+```
+
+Or:
+
+```sh
+pip install figfoundry
+# or from this repository:
+uv tool install figfoundry --from "git+https://github.com/ductai199x/figfoundry.git"
+```
+
+Python 3.10 or newer. It runs wherever Python and a browser do.
+
+<details>
+<summary>Development</summary>
+
+```sh
+uv sync --extra dev
+uv run --extra dev pytest -q          # 152 tests
+uv run --with ruff ruff check .       # lint
+uv run figfoundry serve               # the app
+```
+
+The suite covers the WYSIWYG invariant for every plot type, the pickle whitelist, dataset I/O
+(npz/pkl/csv), vector export, the CLI, and the API through a test client. CI runs it, plus the
+build and an artifact check, on Linux and Windows for Python 3.10 and 3.12
+([.github/workflows/ci.yml](.github/workflows/ci.yml)).
+
+</details>
+
+## License
+
+Copyright (C) 2026 Tai Duc Nguyen.
+
+Fig Foundry is licensed under the [MIT License](LICENSE): use it, study it, change it and
+share it. The one sample dataset it ships is synthetic; your own data never leaves your
+machine.

{figfoundry-0.1.0 → figfoundry-0.2.0}/figfoundry/static/canvas.css

@@ -105,7 +105,14 @@ select.ctl-sel:focus { border-color: var(--accent); box-shadow: 0 0 0 3px var(--
 .v3-row { display: grid; grid-template-columns: 78px 1fr 46px; align-items: center; gap: 12px; }
 .v3-lab { font-size: 12.5px; font-weight: 600; color: var(--ink); }
 .v3-range { width: 100%; cursor: pointer; }
-.v3-val { font-size: 12px; color: var(--muted); font-variant-numeric: tabular-nums; text-align: right; }
+.v3-val {
+  font-size: 12px; color: var(--ink); font-variant-numeric: tabular-nums; text-align: right; font-family: inherit; font-weight: 600;
+  width: 100%; background: transparent; border: 1px solid transparent; border-radius: 5px;
+  padding: 1px 5px; margin: -1px -5px;
+  cursor: default; transition: background .12s ease, border-color .12s ease, box-shadow .12s ease;
+}
+.v3-val:hover { background: var(--hover); cursor: text; }
+.v3-val:focus { background: var(--input-bg); border-color: var(--accent); cursor: text; outline: none; box-shadow: 0 0 0 3px var(--accent-weak); }
 .v3-toggles { display: flex; gap: 22px; margin-top: 3px; padding-top: 12px; border-top: 1px solid var(--line); }
 .v3-check { display: flex; align-items: center; gap: 7px; font-size: 12.5px; color: var(--ink); cursor: pointer; user-select: none; }
 .v3-check input { accent-color: var(--accent); cursor: pointer; width: 15px; height: 15px; }

{figfoundry-0.1.0 → figfoundry-0.2.0}/figfoundry/static/canvas.html

@@ -111,17 +111,17 @@
         <div class="v3-row">
           <label class="v3-lab" for="v3e">Elevation</label>
           <input type="range" id="v3e" class="v3-range" min="-90" max="90" step="1">
-          <span class="v3-val" id="v3eVal">30&deg;</span>
+          <input type="text" class="v3-val num-in" id="v3eVal" value="30" inputmode="decimal" spellcheck="false" aria-label="Elevation value">
         </div>
         <div class="v3-row">
           <label class="v3-lab" for="v3a">Azimuth</label>
           <input type="range" id="v3a" class="v3-range" min="-180" max="180" step="1">
-          <span class="v3-val" id="v3aVal">-60&deg;</span>
+          <input type="text" class="v3-val num-in" id="v3aVal" value="-60" inputmode="decimal" spellcheck="false" aria-label="Azimuth value">
         </div>
         <div class="v3-row">
           <label class="v3-lab" for="v3d">Zoom</label>
           <input type="range" id="v3d" class="v3-range" min="3" max="22" step="0.5">
-          <span class="v3-val" id="v3dVal">10</span>
+          <input type="text" class="v3-val num-in" id="v3dVal" value="10" inputmode="decimal" spellcheck="false" aria-label="Zoom value">
         </div>
         <div class="v3-toggles">
           <label class="v3-check"><input type="checkbox" id="v3invR"> Invert rotate</label>

{figfoundry-0.1.0 → figfoundry-0.2.0}/figfoundry/static/canvas.js

@@ -1063,11 +1063,38 @@ function hint(t) { const h = document.createElement("div"); h.className = "hint"
 function slider(label, path, val, min, max, step, afterChange) {
   const w = document.createElement("div"); w.className = "ctl";
   const head = document.createElement("div"); head.className = "ctl-head";
-  const lab = document.createElement("label"); lab.textContent = label; const vv = document.createElement("span"); vv.className = "val"; vv.textContent = fmt(val, step);
+  const lab = document.createElement("label"); lab.textContent = label;
+  // The value is a click-to-edit number field: plain text by default, an input
+  // box on focus. Type a value and commit with Enter or blur (click outside);
+  // Esc reverts. This is the only way to enter an exact number (the slider is
+  // for coarse adjustment), so it must stay in sync with the range input.
+  const vv = document.createElement("input"); vv.type = "text"; vv.className = "val num-in";
+  vv.inputMode = "decimal"; vv.spellcheck = false; vv.setAttribute("aria-label", label + " value");
   head.append(lab, vv); w.appendChild(head);
-  const inp = document.createElement("input"); inp.type = "range"; inp.min = min; inp.max = max; inp.step = step; inp.value = val;
-  inp.addEventListener("input", () => { if (state.sliderSnapshot === null) state.sliderSnapshot = clone(state.spec); setPath(state.spec, path, parseFloat(inp.value)); vv.textContent = fmt(parseFloat(inp.value), step); scheduleDraft(); });
+  const inp = document.createElement("input"); inp.type = "range"; inp.min = min; inp.max = max; inp.step = step;
+  let cur = val;
+  const paint = () => { if (document.activeElement !== vv) vv.value = fmt(cur, step); inp.value = cur; };
+  paint();
+  function live(v) {
+    if (isNaN(v)) return;
+    if (state.sliderSnapshot === null) state.sliderSnapshot = clone(state.spec);
+    cur = v; setPath(state.spec, path, v); paint(); scheduleDraft();
+  }
+  inp.addEventListener("input", () => live(parseFloat(inp.value)));
   inp.addEventListener("change", () => { commitSnapshot(); if (afterChange) afterChange(); commit(); });
+  function commitVal() {
+    const v = parseFloat(vv.value);
+    if (isNaN(v)) { paint(); return; }               // not a number: keep the last good value
+    const cv = Math.max(min, Math.min(max, v));      // clamp to the slider's range
+    if (state.sliderSnapshot === null) state.sliderSnapshot = clone(state.spec);
+    cur = cv; setPath(state.spec, path, cv); inp.value = cv; vv.value = fmt(cv, step);
+    commitSnapshot(); if (afterChange) afterChange(); commit();
+  }
+  vv.addEventListener("change", commitVal);          // commit on blur (click outside)
+  vv.addEventListener("keydown", (e) => {
+    if (e.key === "Enter") { e.preventDefault(); vv.blur(); }   // commit on Enter
+    else if (e.key === "Escape") paint();                       // discard on Esc
+  });
   w.appendChild(inp); return w;
 }
 function text(label, path, val) {
@@ -1178,10 +1205,11 @@ const v3dPref = (k) => { try { return localStorage.getItem("figfoundry.invert3d.
 const v3dSetPref = (k, v) => { try { localStorage.setItem("figfoundry.invert3d." + k, v ? "1" : "0"); } catch (e) {} };
 function v3dVals() {
   if (!v3d) return;
-  const e = $("#v3eVal"), a = $("#v3aVal"), z = $("#v3dVal");
-  if (e) e.textContent = Math.round(v3d.elev) + "°";
-  if (a) a.textContent = Math.round(v3d.azim) + "°";
-  if (z) z.textContent = (Math.round(v3d.dist * 10) / 10);
+  // The value fields are editable inputs; don't clobber the one being typed into.
+  const set = (id, v) => { const el = $(id); if (el && document.activeElement !== el) el.value = v; };
+  set("#v3eVal", Math.round(v3d.elev));
+  set("#v3aVal", Math.round(v3d.azim));
+  set("#v3dVal", Math.round(v3d.dist * 10) / 10);
 }
 
 async function openView3D(pid) {
@@ -1214,6 +1242,20 @@ function v3dWire() {
   $("#v3e").oninput = (e) => { v3d.elev = +e.target.value; v3dVals(); v3dRender(); };
   $("#v3a").oninput = (e) => { v3d.azim = +e.target.value; v3dVals(); v3dRender(); };
   $("#v3d").oninput = (e) => { v3d.dist = +e.target.value; v3dVals(); v3dRender(); };
+  // The value fields are click-to-edit: type an exact number, commit on Enter or
+  // blur, discard on Esc. Keeps the slider + 3-D preview in sync with the typed value.
+  const commit3 = (id, key, lo, hi, sl) => {
+    const el = $(id);
+    el.addEventListener("keydown", (e) => { if (e.key === "Enter") { e.preventDefault(); el.blur(); } else if (e.key === "Escape") v3dVals(); });
+    el.addEventListener("change", () => {
+      let v = parseFloat(el.value);
+      if (isNaN(v)) { v3dVals(); return; }
+      v = clamp(v, lo, hi); v3d[key] = v; $(sl).value = v; v3dVals(); v3dRender();
+    });
+  };
+  commit3("#v3eVal", "elev", -90, 90, "#v3e");
+  commit3("#v3aVal", "azim", -180, 180, "#v3a");
+  commit3("#v3dVal", "dist", 3, 22, "#v3d");
   $("#v3invR").onchange = (e) => { if (v3d) v3d.invertR = e.target.checked; v3dSetPref("rotate", e.target.checked); };
   $("#v3invZ").onchange = (e) => { if (v3d) v3d.invertZ = e.target.checked; v3dSetPref("zoom", e.target.checked); };
   const img = $("#view3dImg"); let drag = null;

{figfoundry-0.1.0 → figfoundry-0.2.0}/figfoundry/static/style.css

@@ -254,7 +254,18 @@ a.card { text-decoration: none; color: inherit; display: block; }
 .ctl { margin-bottom: 13px; }
 .ctl .ctl-head { display: flex; justify-content: space-between; align-items: baseline; margin-bottom: 6px; }
 .ctl label { font-size: 12.5px; color: var(--muted); }
-.ctl .val { font-size: 12.5px; color: var(--ink); font-variant-numeric: tabular-nums; font-weight: 600; }
+.ctl .val {
+  font-size: 12.5px; color: var(--ink); font-variant-numeric: tabular-nums; font-weight: 600; font-family: inherit;
+  width: 68px; text-align: right;
+  background: transparent; border: 1px solid transparent; border-radius: 5px;
+  padding: 1px 6px; margin: -1px -6px;   /* padding + negative margin: the box appears on focus without shifting the number */
+  cursor: default; transition: background .12s ease, border-color .12s ease, box-shadow .12s ease;
+}
+.ctl .val:hover { background: var(--hover); cursor: text; }
+.ctl .val:focus {
+  background: var(--input-bg); border-color: var(--accent); cursor: text; outline: none;
+  box-shadow: 0 0 0 3px var(--accent-weak);
+}
 
 input[type="range"] {
   width: 100%; height: 4px; -webkit-appearance: none; appearance: none;

{figfoundry-0.1.0 → figfoundry-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "figfoundry"
-version = "0.1.0"
+version = "0.2.0"
 description = "WYSIWYG matplotlib figure composer: load data (.npz/.pkl), drag signals onto a canvas to build plots, and export clean reproducible code."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -48,8 +48,9 @@ build-backend = "hatchling.build"
 packages = ["figfoundry"]
 
 [tool.hatch.build.targets.sdist]
-# tests/ is dev-only; keep it out of the published source distribution
-exclude = ["tests"]
+# tests/ is dev-only; media/ (README screenshots) and .github/ (CI) are not
+# needed to install the package, so keep them out of the source distribution.
+exclude = ["tests", "media", ".github", "dist"]
 
 [tool.ruff]
 line-length = 110

figfoundry-0.1.0/PKG-INFO

@@ -1,125 +0,0 @@
-Metadata-Version: 2.5
-Name: figfoundry
-Version: 0.1.0
-Summary: WYSIWYG matplotlib figure composer: load data (.npz/.pkl), drag signals onto a canvas to build plots, and export clean reproducible code.
-Project-URL: Homepage, https://github.com/ductai199x/figfoundry
-Project-URL: Repository, https://github.com/ductai199x/figfoundry
-Project-URL: Issues, https://github.com/ductai199x/figfoundry/issues
-Author-email: Tai Duc Nguyen <taiducnguyen.drexel@gmail.com>
-License-Expression: MIT
-License-File: LICENSE
-Keywords: data-visualization,figures,matplotlib,plotting,scientific-figures,wysiwyg
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Web Environment
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Multimedia :: Graphics
-Classifier: Topic :: Scientific/Engineering :: Visualization
-Requires-Python: >=3.10
-Requires-Dist: fastapi>=0.110
-Requires-Dist: matplotlib>=3.9
-Requires-Dist: numpy>=1.24
-Requires-Dist: pydantic>=2.0
-Requires-Dist: python-multipart>=0.0.9
-Requires-Dist: uvicorn>=0.29
-Provides-Extra: dev
-Requires-Dist: httpx2>=2.0; extra == 'dev'
-Requires-Dist: pytest>=8.0; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# Fig Foundry
-
-A WYSIWYG matplotlib figure composer. Load your data (`.npz` / `.pkl` / `.csv`),
-drag signals onto a free canvas to build plots, arrange and style them, and export
-clean, reproducible Python.
-
-**The preview renders by executing the generated code**, so what you see is
-byte-for-byte what the exported `.py` produces. There is no second renderer to
-drift.
-
-Fig Foundry is a standalone local app with no dependency on any particular
-project's data. It ships with a small neutral `sample.npz` (1-D signals plus a
-2-D field) so a fresh install has something to open; load your own dataset to work
-with real data.
-
-## Install
-
-```bash
-uv tool install ./path/to/fig_editor     # installs a `figfoundry` command
-# or, from a git repo:
-uv tool install figfoundry --from "git+https://github.com/<you>/<repo>.git"
-```
-
-Then run:
-
-```bash
-figfoundry             # starts the web app on http://127.0.0.1:8037 and opens the browser
-figfoundry serve --port 9000 --no-browser
-```
-
-## Command line
-
-The same engines are available as subcommands for scripting:
-
-```bash
-figfoundry list                              # list saved figures
-figfoundry new --name my-fig                 # create a blank figure, print its slug
-figfoundry export SLUG [--out PATH]          # write a figure's generated .py
-figfoundry render SLUG --format svg|pdf|png  # render a figure to a file
-figfoundry datasets                          # list available datasets
-```
-
-## Data
-
-A *dataset* is a named collection of signals (arrays). Supported formats:
-
-- **`.npz`** — numpy zip of named arrays. Safe by construction.
-- **`.pkl`** — Python pickle, loaded through a **whitelist unpickler** that only
-  permits numpy arrays and plain containers (blocks `os`, `subprocess`, `socket`,
-  `ctypes`, …). A malicious pickle cannot execute code.
-- **`.csv`** — a table with a header row; each numeric column becomes a signal.
-
-1-D and 2-D arrays are both supported (2-D for image/contour/vector plots). Load a
-dataset with the **Load data…** button in the toolbar; each canvas is tied to one
-dataset, and its signals populate the library.
-
-Your figures, datasets, and exports live in `~/.figfoundry/`.
-
-## What you can do
-
-- Drag a signal onto the canvas to make a plot (or onto an existing plot to
-  overlay a line / σ-band / error bars / replace).
-- **Plot types (23):** line, step, scatter, grouped scatter (clustering), bar,
-  bar (horizontal), histogram, box plot, violin plot, 2-D histogram, hexbin, image,
-  contour (filled / lines), pcolormesh, vector field, streamplot, decision boundary,
-  pie, polar, 3-D scatter, surface (3-D), wireframe (3-D).
-- Move, resize (with snapping), and nudge (arrow keys) plots and elements.
-- Multi-select (Shift+click) to nudge / move / delete several at once.
-- Per-plot: data, color, line/marker, σ-band, error bars, ticks, labels, limits,
-  spines, title, colormap + colorbar, and artists (vline, hline, text, annotate,
-  arrow, box, circle, ellipse, polygon, span, legend).
-- **Suggest accessible colors** — one click applies the colorblind-safe Okabe-Ito
-  palette to a plot's series.
-- **LaTeX mathtext** in labels, titles, and text (e.g. `$x_0$`).
-- Layout: grid, align, distribute, margins, sync axis ranges.
-- Figure elements: axis labels, legend, suptitle, free text.
-- Name / duplicate / delete figures. Export the `.py` (copy or download), and the
-  figure itself as **PNG / SVG / PDF** (SVG and PDF are vector, for publication).
-
-Everything is also available through a small JSON API (`/api/canvases`,
-`/api/datasets`, `/api/palettes`, `/api/canvases/{slug}/render|code|figure|download`).
-
-## Testing
-
-The test suite lives in `tests/` (outside the package, so it is never shipped).
-It proves the WYSIWYG invariant (for every plot type), the pickle-safety
-whitelist, and dataset I/O (npz/pkl/csv), each against a throwaway data dir:
-
-```bash
-uv run --extra dev pytest -q
-```

figfoundry-0.1.0/README.md

@@ -1,91 +0,0 @@
-# Fig Foundry
-
-A WYSIWYG matplotlib figure composer. Load your data (`.npz` / `.pkl` / `.csv`),
-drag signals onto a free canvas to build plots, arrange and style them, and export
-clean, reproducible Python.
-
-**The preview renders by executing the generated code**, so what you see is
-byte-for-byte what the exported `.py` produces. There is no second renderer to
-drift.
-
-Fig Foundry is a standalone local app with no dependency on any particular
-project's data. It ships with a small neutral `sample.npz` (1-D signals plus a
-2-D field) so a fresh install has something to open; load your own dataset to work
-with real data.
-
-## Install
-
-```bash
-uv tool install ./path/to/fig_editor     # installs a `figfoundry` command
-# or, from a git repo:
-uv tool install figfoundry --from "git+https://github.com/<you>/<repo>.git"
-```
-
-Then run:
-
-```bash
-figfoundry             # starts the web app on http://127.0.0.1:8037 and opens the browser
-figfoundry serve --port 9000 --no-browser
-```
-
-## Command line
-
-The same engines are available as subcommands for scripting:
-
-```bash
-figfoundry list                              # list saved figures
-figfoundry new --name my-fig                 # create a blank figure, print its slug
-figfoundry export SLUG [--out PATH]          # write a figure's generated .py
-figfoundry render SLUG --format svg|pdf|png  # render a figure to a file
-figfoundry datasets                          # list available datasets
-```
-
-## Data
-
-A *dataset* is a named collection of signals (arrays). Supported formats:
-
-- **`.npz`** — numpy zip of named arrays. Safe by construction.
-- **`.pkl`** — Python pickle, loaded through a **whitelist unpickler** that only
-  permits numpy arrays and plain containers (blocks `os`, `subprocess`, `socket`,
-  `ctypes`, …). A malicious pickle cannot execute code.
-- **`.csv`** — a table with a header row; each numeric column becomes a signal.
-
-1-D and 2-D arrays are both supported (2-D for image/contour/vector plots). Load a
-dataset with the **Load data…** button in the toolbar; each canvas is tied to one
-dataset, and its signals populate the library.
-
-Your figures, datasets, and exports live in `~/.figfoundry/`.
-
-## What you can do
-
-- Drag a signal onto the canvas to make a plot (or onto an existing plot to
-  overlay a line / σ-band / error bars / replace).
-- **Plot types (23):** line, step, scatter, grouped scatter (clustering), bar,
-  bar (horizontal), histogram, box plot, violin plot, 2-D histogram, hexbin, image,
-  contour (filled / lines), pcolormesh, vector field, streamplot, decision boundary,
-  pie, polar, 3-D scatter, surface (3-D), wireframe (3-D).
-- Move, resize (with snapping), and nudge (arrow keys) plots and elements.
-- Multi-select (Shift+click) to nudge / move / delete several at once.
-- Per-plot: data, color, line/marker, σ-band, error bars, ticks, labels, limits,
-  spines, title, colormap + colorbar, and artists (vline, hline, text, annotate,
-  arrow, box, circle, ellipse, polygon, span, legend).
-- **Suggest accessible colors** — one click applies the colorblind-safe Okabe-Ito
-  palette to a plot's series.
-- **LaTeX mathtext** in labels, titles, and text (e.g. `$x_0$`).
-- Layout: grid, align, distribute, margins, sync axis ranges.
-- Figure elements: axis labels, legend, suptitle, free text.
-- Name / duplicate / delete figures. Export the `.py` (copy or download), and the
-  figure itself as **PNG / SVG / PDF** (SVG and PDF are vector, for publication).
-
-Everything is also available through a small JSON API (`/api/canvases`,
-`/api/datasets`, `/api/palettes`, `/api/canvases/{slug}/render|code|figure|download`).
-
-## Testing
-
-The test suite lives in `tests/` (outside the package, so it is never shipped).
-It proves the WYSIWYG invariant (for every plot type), the pickle-safety
-whitelist, and dataset I/O (npz/pkl/csv), each against a throwaway data dir:
-
-```bash
-uv run --extra dev pytest -q
-```