plotstyle 1.2.1__tar.gz → 1.2.3__tar.gz

{plotstyle-1.2.1 → plotstyle-1.2.3}/.gitignore

@@ -160,3 +160,5 @@ secrets.json
 
 # local files
 local/
+
+.claude

{plotstyle-1.2.1 → plotstyle-1.2.3}/CHANGELOG.md

@@ -13,6 +13,56 @@ _Nothing yet._
 
 ---
 
+## [1.2.3] - 2026-04-30
+
+Minor release: automatic journal color cycle, `target_font_pt` typography field, Nature-specific rcParams, CLI improvements, a full documentation and example audit, and a new doc image generation script.
+
+### Added
+
+- **Automatic journal palette as default color cycle** (`plotstyle.use()`): calling `use("nature")` (or any journal key) now sets the journal's recommended palette as `axes.prop_cycle` automatically. Every `ax.plot()`, `ax.bar()`, and `ax.scatter()` call draws from it without any `color=` argument. A color overlay applied in the same `use()` call overrides this default.
+- **`target_font_pt` field on `TypographySpec`**: optional `float | None` field that records a journal's explicitly stated target font size (as opposed to only a min/max range). When set, `build_rcparams()` uses it as `font.size` instead of the midpoint of the range. `nature.toml` sets `target_font_pt = 7.0` (Nature's guidelines explicitly state 7 pt as the standard text size).
+- **`plotstyle info` CLI shows `Target size:`**: when `target_font_pt` is set for a journal, the `plotstyle info <journal>` command now prints a `Target size:` line under Typography.
+- **Nature-specific tick and legend rcParams** (`build_rcparams()`): the Nature preset now applies inward-facing ticks (`xtick.direction: in`, `ytick.direction: in`), minor ticks visible on all axes, mirrored tick marks (`xtick.top: True`, `ytick.right: True`), and `legend.frameon: False` - matching Nature's published figure style guidelines.
+- **`scripts/generate_docs_images.py`**: new script that regenerates all 9 static PNG images used in the documentation (`docs/images/`) from the current codebase in one headless run.
+- **Docs images regenerated**: all 9 images in `docs/images/` rebuilt using the updated codebase - `quickstart_nature.png`, `multi_panel_science.png`, `palette_comparison.png`, `accessibility_colorblind.png`, `accessibility_grayscale.png`, `gallery_nature.png`, `gallery_ieee.png`, `seaborn_scatter_nature.png`, `overlay_bar.png`.
+- **New test coverage**: `TestUseColorCycle` (automatic palette cycle), `TestUseFontSizeTarget` (target_font_pt font size selection), `TestBuildRcparamsLegend` (Nature legend.frameon), and `TestBuildRcparamsTicks` (Nature inward/mirrored tick rcParams).
+
+### Changed
+
+- **`examples/03_color_palettes.py`**: added Section 1 demonstrating the automatic default color cycle; renumbered remaining sections 2-6.
+- **`examples/05_validation.py`**: added `is_failure` / `is_warning` convenience property usage.
+- **`examples/09_registry_and_spec.py`**: expanded to cover `target_font_pt`, `is_official`, `assumed_fields`, and `registry.preload()`.
+- **`examples/12_overlays.py`**: added color overlay, grid rendering overlay, scatter + IEEE warning, overlay inspection, and `list_overlays()` with category filter. Imports reorganized to comply with E402 (module-level imports at top); unused loop variable renamed to `_ls` to comply with B007.
+- **Docs**: all docs updated to reflect the automatic palette cycle and `target_font_pt` changes; `colour` spelling standardized to `color` throughout.
+
+---
+
+## [1.2.2] - 2026-04-27
+
+Patch release: docs improvements, README example quality, and CI action bump.
+
+### Added
+
+- **`LatexNotFoundError` catch pattern in API docs** (`docs/api/style.md`): new "Catching LaTeX errors" section shows how to import and handle `LatexNotFoundError` directly, with a note on catching the base `RuntimeError` as an alternative.
+- **`examples/output/accessibility_deuteranopia.png`**: new reference output image generated by the `simulate_cvd` section of `04_accessibility_checks.py`.
+
+### Changed
+
+- **README overlay examples use realistic data**: notebook and okabe-ito overlay snippets now use `np.linspace` / `np.sin` / `np.cos` plots instead of trivial `[1, 2, 3]` lists; axes labels updated to match.
+- **README overlay snippet import cleanup**: removed stray `import matplotlib.pyplot as plt` from the minimal overlay example where it was unused.
+- **README validation report output updated**: sample terminal output now reflects a two-column figure width rather than a single-column one.
+- **README `diff` output adds `Avoid: none`**: accessibility block in the `plotstyle diff` sample output now shows the `Avoid` field.
+- **`download-artifact` action bumped to v8** in `.github/workflows/release.yml` (was v4).
+- **Version references bumped to 1.2.2** in `README.md` (citation note) and `docs/installation.md` (version-check snippet).
+
+### Fixed
+
+- **HiDPI/Retina crash in `_fig_to_rgb_array`** (`src/plotstyle/color/_rendering.py`): `get_width_height()` now passes `physical=True` so the returned pixel dimensions match the `buffer_rgba()` byte count on high-DPI displays, preventing a `ValueError` during the reshape.
+- **Same HiDPI fix in `simulate_cvd` example** (`examples/04_accessibility_checks.py`): the inline canvas-to-array snippet now uses `get_width_height(physical=True)` to stay consistent with the library fix above.
+- **Typo in `06_export_submission.py` docstring**: `"smit_"` author prefix corrected to `"smith_"`.
+
+---
+
 ## [1.2.1] - 2026-04-26
 
 Patch release: `simulate_cvd` example, warning quality improvements, and docs/example content fixes.
@@ -146,7 +196,9 @@ First public alpha release.
 - **Dynamic versioning**: version derived from git tags via `hatch-vcs` and `importlib.metadata`.
 - **CI/CD pipeline**: GitHub Actions workflows for lint, type-check, test matrix, and automated PyPI release via OIDC Trusted Publishing.
 
-[Unreleased]: https://github.com/rahulkaushal04/plotstyle/compare/v1.2.1...HEAD
+[Unreleased]: https://github.com/rahulkaushal04/plotstyle/compare/v1.2.3...HEAD
+[1.2.3]: https://github.com/rahulkaushal04/plotstyle/compare/v1.2.2...v1.2.3
+[1.2.2]: https://github.com/rahulkaushal04/plotstyle/compare/v1.2.1...v1.2.2
 [1.2.1]: https://github.com/rahulkaushal04/plotstyle/compare/v1.2.0...v1.2.1
 [1.2.0]: https://github.com/rahulkaushal04/plotstyle/compare/v1.1.0...v1.2.0
 [1.1.0]: https://github.com/rahulkaushal04/plotstyle/compare/v1.0.0...v1.1.0

{plotstyle-1.2.1 → plotstyle-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotstyle
-Version: 1.2.1
+Version: 1.2.3
 Summary: Matplotlib/seaborn style presets matching scientific journal requirements, with validation, export safety, and preview capabilities.
 Project-URL: Homepage, https://github.com/rahulkaushal04/plotstyle
 Project-URL: Documentation, https://plotstyle.readthedocs.io
@@ -99,6 +99,14 @@ Description-Content-Type: text/markdown
 
 **PlotStyle** makes it easy to produce Matplotlib figures that meet the exact typographic, dimensional, and export requirements of major academic journals. It also integrates with Seaborn, with more integrations planned. Pick a journal, create your figure, save it. PlotStyle handles the rest.
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/rahulkaushal04/plotstyle/main/examples/output/before_after.png" width="90%" alt="Left: default Matplotlib output. Right: the same figure styled with plotstyle.use('nature').">
+</p>
+
+<p align="center">
+  <em>Left: default Matplotlib. Right: <code>plotstyle.use("nature")</code>. Same data, same code.</em>
+</p>
+
 ---
 
 ## Table of Contents
@@ -115,6 +123,8 @@ Description-Content-Type: text/markdown
 - [CLI](#cli)
 - [Documentation](#documentation)
 - [Contributing](#contributing)
+- [Code of Conduct](#code-of-conduct)
+- [Security](#security)
 - [Citation](#citation)
 - [License](#license)
 
@@ -280,7 +290,6 @@ Overlays are additive patches that layer on top of a journal preset. They let yo
 Pass overlay names in the same list as the journal key:
 
 ```python
-import matplotlib.pyplot as plt
 import plotstyle
 
 # Strip top/right spines for a clean editorial look
@@ -298,15 +307,19 @@ with plotstyle.use(["nature", "minimal"]) as style:
 </p>
 
 ```python
+import numpy as np
 import matplotlib.pyplot as plt
 import plotstyle
 
+x = np.linspace(0, 2 * np.pi, 100)
+
 # Larger figure and fonts for Jupyter notebooks
 with plotstyle.use(["nature", "notebook"]) as style:
     fig, ax = plt.subplots()   # plt.subplots() picks up the notebook figsize
-    ax.plot([1, 2, 3], label="data")
-    ax.set_xlabel("x")
-    ax.set_ylabel("y")
+    ax.plot(x, np.sin(x), label="sin(x)")
+    ax.plot(x, np.cos(x), label="cos(x)")
+    ax.set_xlabel("Phase (rad)")
+    ax.set_ylabel("Amplitude")
     ax.legend()
     style.savefig(fig, "notebook_figure.pdf")
 ```
@@ -316,13 +329,16 @@ with plotstyle.use(["nature", "notebook"]) as style:
 </p>
 
 ```python
-import matplotlib.pyplot as plt
+import numpy as np
 import plotstyle
 
+x = np.linspace(0, 2 * np.pi, 100)
+
 # Swap the colour cycle to a specific palette
 with plotstyle.use(["ieee", "okabe-ito"]) as style:
     fig, ax = style.figure(columns=1)
-    ax.plot([1, 2, 3], label="data")
+    for i in range(4):
+        ax.plot(x, np.sin(x + i * 0.5), label=f"Series {i + 1}")
     ax.set_xlabel("x")
     ax.set_ylabel("y")
     ax.legend()
@@ -409,7 +425,7 @@ import plotstyle
 
 x = np.linspace(0, 2 * np.pi, 100)
 
-# Outside plotstyle.use() — some checks will fail
+# Outside plotstyle.use(): some checks will fail
 fig, ax = plt.subplots()
 ax.plot(x, np.sin(x), label="sin(x)")
 ax.set_xlabel("Phase (rad)")
@@ -418,14 +434,14 @@ ax.legend()
 
 report = plotstyle.validate(fig, journal="nature")
 print(report)          # formatted compliance table
-print(report.passed)   # False — rcParams not configured
+print(report.passed)   # False, rcParams not configured
 
 for failure in report.failures:
     print(failure.message)         # what failed
     print(failure.fix_suggestion)  # how to fix it
 plt.close(fig)
 
-# Inside plotstyle.use() — all checks pass
+# Inside plotstyle.use(): all checks pass
 with plotstyle.use("nature") as style:
     fig, ax = style.figure(columns=1)
     ax.plot(x, np.sin(x), label="sin(x)")
@@ -442,15 +458,15 @@ with plotstyle.use("nature") as style:
 ┌──────────────────────────────────────────────────────┐
 │         PlotStyle Validation Report: Nature          │
 ├──────────┬───────────────────────────────────────────┤
-│ ✓ PASS   │ Figure width 89.0mm matches single colu...│
-│ ✓ PASS   │ Figure height 55.0mm is within the Natu...│
+│ ✗ FAIL   │ Figure width 162.6mm does not match Nat...│
+│ ✓ PASS   │ Figure height 121.9mm is within the Nat...│
 │ ✗ FAIL   │ pdf.fonttype = 3; must be 42 for TrueTy...│
 │ ✗ FAIL   │ ps.fonttype = 3; must be 42 for TrueTyp...│
 │ ⚠ WARN   │ savefig.dpi = 'figure'; Nature requires...│
 │ ✓ PASS   │ All plotted lines and spines meet the N...│
-│ ✗ FAIL   │ 14 text element(s) outside the Nature r...│
+│ ✗ FAIL   │ 23 text element(s) outside the Nature r...│
 └──────────┴───────────────────────────────────────────┘
-3/7 checks passed, 1 warning(s), 3 failure(s)
+2/7 checks passed, 1 warning(s), 4 failure(s)
 
 passed: False
 
@@ -580,6 +596,7 @@ Export:
 Accessibility:
   Colorblind safe: Not required
   Grayscale safe:  Not required
+  Avoid:           none
 ```
 
 **`plotstyle diff nature science`**
@@ -653,7 +670,34 @@ Full documentation at **[plotstyle.readthedocs.io](https://plotstyle.readthedocs
 - [CLI reference](https://plotstyle.readthedocs.io/en/stable/cli.html)
 - [FAQ](https://plotstyle.readthedocs.io/en/stable/faq.html)
 
-Working examples are in the [`examples/`](examples/) directory.
+Working examples are in the [`examples/`](https://github.com/rahulkaushal04/plotstyle/tree/main/examples/) directory:
+
+| Example | What it covers |
+|---------|----------------|
+| [`01_quickstart.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/01_quickstart.py) | Apply a journal preset, create a figure, and save |
+| [`02_multi_panel_figure.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/02_multi_panel_figure.py) | Multi-panel layouts with automatic panel labels |
+| [`03_color_palettes.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/03_color_palettes.py) | Journal palettes, grayscale-safe markers, `apply_palette` |
+| [`04_accessibility_checks.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/04_accessibility_checks.py) | Colorblind simulation and grayscale print-safety |
+| [`05_validation.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/05_validation.py) | Validate a figure against journal requirements |
+| [`06_export_submission.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/06_export_submission.py) | Export in all required formats for submission |
+| [`07_spec_diff_and_migrate.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/07_spec_diff_and_migrate.py) | Compare journals and migrate a figure between them |
+| [`08_gallery_preview.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/08_gallery_preview.py) | Discover journals and preview their styles |
+| [`09_registry_and_spec.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/09_registry_and_spec.py) | Inspect journal specs from the registry |
+| [`10_context_manager_patterns.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/10_context_manager_patterns.py) | Patterns for managing rcParam lifetime |
+| [`11_seaborn_integration.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/11_seaborn_integration.py) | Keep PlotStyle settings intact with Seaborn |
+| [`12_overlays.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/12_overlays.py) | Overlays: context, color, and plot-type |
+| [`14_print_size_preview.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/14_print_size_preview.py) | Preview a figure at its true physical print size |
+| [`15_matplotlib_native_styles.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/15_matplotlib_native_styles.py) | Use PlotStyle presets with `plt.style` |
+| [`16_latex_and_fonts.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/16_latex_and_fonts.py) | LaTeX modes and font availability checks |
+
+Interactive Jupyter notebooks are in [`examples/notebooks/`](https://github.com/rahulkaushal04/plotstyle/tree/main/examples/notebooks/):
+
+| Notebook | What it covers |
+|----------|----------------|
+| [`01_quickstart.ipynb`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/notebooks/01_quickstart.ipynb) | Full quickstart: style, figure, palette, validate, save, overlays |
+| [`02_accessibility_and_validation.ipynb`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/notebooks/02_accessibility_and_validation.ipynb) | Colorblind and grayscale previews, validation reports |
+| [`03_journal_comparison_and_migration.ipynb`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/notebooks/03_journal_comparison_and_migration.ipynb) | Diff journals and migrate figures between them |
+| [`04_overlays.ipynb`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/notebooks/04_overlays.ipynb) | Overlays in depth: context, color, plot-type, combining |
 
 ---
 
@@ -661,21 +705,27 @@ Working examples are in the [`examples/`](examples/) directory.
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, adding journal specs, and pull request guidelines.
 
+All contributors are expected to follow the [Code of Conduct](CODE_OF_CONDUCT.md).
+
+---
+
+## Code of Conduct
+
+This project follows the [Contributor Covenant](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this standard.
+
+---
+
+## Security
+
+To report a security vulnerability, use [GitHub's private vulnerability reporting](https://github.com/rahulkaushal04/plotstyle/security/advisories/new) rather than opening a public issue. See [SECURITY.md](SECURITY.md) for scope, timeline, and disclosure guidelines.
+
 ---
 
 ## Citation
 
-If PlotStyle helps your research, a citation or star is appreciated:
+If PlotStyle helps your research, a citation or star is appreciated.
 
-```bibtex
-@misc{plotstyle,
-  author  = {Kaushal, Rahul},
-  title   = {PlotStyle: Publication-ready scientific figure presets for Matplotlib},
-  year    = {2026},
-  url     = {https://github.com/rahulkaushal04/plotstyle},
-  note    = {Version 1.2.1},
-}
-```
+Use the **"Cite this repository"** button on the GitHub sidebar to get a ready-to-use APA or BibTeX entry. It reads from [`CITATION.cff`](CITATION.cff) and is always up to date.
 
 ---
 

{plotstyle-1.2.1 → plotstyle-1.2.3}/README.md

@@ -18,6 +18,14 @@
 
 **PlotStyle** makes it easy to produce Matplotlib figures that meet the exact typographic, dimensional, and export requirements of major academic journals. It also integrates with Seaborn, with more integrations planned. Pick a journal, create your figure, save it. PlotStyle handles the rest.
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/rahulkaushal04/plotstyle/main/examples/output/before_after.png" width="90%" alt="Left: default Matplotlib output. Right: the same figure styled with plotstyle.use('nature').">
+</p>
+
+<p align="center">
+  <em>Left: default Matplotlib. Right: <code>plotstyle.use("nature")</code>. Same data, same code.</em>
+</p>
+
 ---
 
 ## Table of Contents
@@ -34,6 +42,8 @@
 - [CLI](#cli)
 - [Documentation](#documentation)
 - [Contributing](#contributing)
+- [Code of Conduct](#code-of-conduct)
+- [Security](#security)
 - [Citation](#citation)
 - [License](#license)
 
@@ -199,7 +209,6 @@ Overlays are additive patches that layer on top of a journal preset. They let yo
 Pass overlay names in the same list as the journal key:
 
 ```python
-import matplotlib.pyplot as plt
 import plotstyle
 
 # Strip top/right spines for a clean editorial look
@@ -217,15 +226,19 @@ with plotstyle.use(["nature", "minimal"]) as style:
 </p>
 
 ```python
+import numpy as np
 import matplotlib.pyplot as plt
 import plotstyle
 
+x = np.linspace(0, 2 * np.pi, 100)
+
 # Larger figure and fonts for Jupyter notebooks
 with plotstyle.use(["nature", "notebook"]) as style:
     fig, ax = plt.subplots()   # plt.subplots() picks up the notebook figsize
-    ax.plot([1, 2, 3], label="data")
-    ax.set_xlabel("x")
-    ax.set_ylabel("y")
+    ax.plot(x, np.sin(x), label="sin(x)")
+    ax.plot(x, np.cos(x), label="cos(x)")
+    ax.set_xlabel("Phase (rad)")
+    ax.set_ylabel("Amplitude")
     ax.legend()
     style.savefig(fig, "notebook_figure.pdf")
 ```
@@ -235,13 +248,16 @@ with plotstyle.use(["nature", "notebook"]) as style:
 </p>
 
 ```python
-import matplotlib.pyplot as plt
+import numpy as np
 import plotstyle
 
+x = np.linspace(0, 2 * np.pi, 100)
+
 # Swap the colour cycle to a specific palette
 with plotstyle.use(["ieee", "okabe-ito"]) as style:
     fig, ax = style.figure(columns=1)
-    ax.plot([1, 2, 3], label="data")
+    for i in range(4):
+        ax.plot(x, np.sin(x + i * 0.5), label=f"Series {i + 1}")
     ax.set_xlabel("x")
     ax.set_ylabel("y")
     ax.legend()
@@ -328,7 +344,7 @@ import plotstyle
 
 x = np.linspace(0, 2 * np.pi, 100)
 
-# Outside plotstyle.use() — some checks will fail
+# Outside plotstyle.use(): some checks will fail
 fig, ax = plt.subplots()
 ax.plot(x, np.sin(x), label="sin(x)")
 ax.set_xlabel("Phase (rad)")
@@ -337,14 +353,14 @@ ax.legend()
 
 report = plotstyle.validate(fig, journal="nature")
 print(report)          # formatted compliance table
-print(report.passed)   # False — rcParams not configured
+print(report.passed)   # False, rcParams not configured
 
 for failure in report.failures:
     print(failure.message)         # what failed
     print(failure.fix_suggestion)  # how to fix it
 plt.close(fig)
 
-# Inside plotstyle.use() — all checks pass
+# Inside plotstyle.use(): all checks pass
 with plotstyle.use("nature") as style:
     fig, ax = style.figure(columns=1)
     ax.plot(x, np.sin(x), label="sin(x)")
@@ -361,15 +377,15 @@ with plotstyle.use("nature") as style:
 ┌──────────────────────────────────────────────────────┐
 │         PlotStyle Validation Report: Nature          │
 ├──────────┬───────────────────────────────────────────┤
-│ ✓ PASS   │ Figure width 89.0mm matches single colu...│
-│ ✓ PASS   │ Figure height 55.0mm is within the Natu...│
+│ ✗ FAIL   │ Figure width 162.6mm does not match Nat...│
+│ ✓ PASS   │ Figure height 121.9mm is within the Nat...│
 │ ✗ FAIL   │ pdf.fonttype = 3; must be 42 for TrueTy...│
 │ ✗ FAIL   │ ps.fonttype = 3; must be 42 for TrueTyp...│
 │ ⚠ WARN   │ savefig.dpi = 'figure'; Nature requires...│
 │ ✓ PASS   │ All plotted lines and spines meet the N...│
-│ ✗ FAIL   │ 14 text element(s) outside the Nature r...│
+│ ✗ FAIL   │ 23 text element(s) outside the Nature r...│
 └──────────┴───────────────────────────────────────────┘
-3/7 checks passed, 1 warning(s), 3 failure(s)
+2/7 checks passed, 1 warning(s), 4 failure(s)
 
 passed: False
 
@@ -499,6 +515,7 @@ Export:
 Accessibility:
   Colorblind safe: Not required
   Grayscale safe:  Not required
+  Avoid:           none
 ```
 
 **`plotstyle diff nature science`**
@@ -572,7 +589,34 @@ Full documentation at **[plotstyle.readthedocs.io](https://plotstyle.readthedocs
 - [CLI reference](https://plotstyle.readthedocs.io/en/stable/cli.html)
 - [FAQ](https://plotstyle.readthedocs.io/en/stable/faq.html)
 
-Working examples are in the [`examples/`](examples/) directory.
+Working examples are in the [`examples/`](https://github.com/rahulkaushal04/plotstyle/tree/main/examples/) directory:
+
+| Example | What it covers |
+|---------|----------------|
+| [`01_quickstart.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/01_quickstart.py) | Apply a journal preset, create a figure, and save |
+| [`02_multi_panel_figure.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/02_multi_panel_figure.py) | Multi-panel layouts with automatic panel labels |
+| [`03_color_palettes.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/03_color_palettes.py) | Journal palettes, grayscale-safe markers, `apply_palette` |
+| [`04_accessibility_checks.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/04_accessibility_checks.py) | Colorblind simulation and grayscale print-safety |
+| [`05_validation.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/05_validation.py) | Validate a figure against journal requirements |
+| [`06_export_submission.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/06_export_submission.py) | Export in all required formats for submission |
+| [`07_spec_diff_and_migrate.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/07_spec_diff_and_migrate.py) | Compare journals and migrate a figure between them |
+| [`08_gallery_preview.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/08_gallery_preview.py) | Discover journals and preview their styles |
+| [`09_registry_and_spec.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/09_registry_and_spec.py) | Inspect journal specs from the registry |
+| [`10_context_manager_patterns.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/10_context_manager_patterns.py) | Patterns for managing rcParam lifetime |
+| [`11_seaborn_integration.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/11_seaborn_integration.py) | Keep PlotStyle settings intact with Seaborn |
+| [`12_overlays.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/12_overlays.py) | Overlays: context, color, and plot-type |
+| [`14_print_size_preview.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/14_print_size_preview.py) | Preview a figure at its true physical print size |
+| [`15_matplotlib_native_styles.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/15_matplotlib_native_styles.py) | Use PlotStyle presets with `plt.style` |
+| [`16_latex_and_fonts.py`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/16_latex_and_fonts.py) | LaTeX modes and font availability checks |
+
+Interactive Jupyter notebooks are in [`examples/notebooks/`](https://github.com/rahulkaushal04/plotstyle/tree/main/examples/notebooks/):
+
+| Notebook | What it covers |
+|----------|----------------|
+| [`01_quickstart.ipynb`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/notebooks/01_quickstart.ipynb) | Full quickstart: style, figure, palette, validate, save, overlays |
+| [`02_accessibility_and_validation.ipynb`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/notebooks/02_accessibility_and_validation.ipynb) | Colorblind and grayscale previews, validation reports |
+| [`03_journal_comparison_and_migration.ipynb`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/notebooks/03_journal_comparison_and_migration.ipynb) | Diff journals and migrate figures between them |
+| [`04_overlays.ipynb`](https://github.com/rahulkaushal04/plotstyle/blob/main/examples/notebooks/04_overlays.ipynb) | Overlays in depth: context, color, plot-type, combining |
 
 ---
 
@@ -580,21 +624,27 @@ Working examples are in the [`examples/`](examples/) directory.
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, adding journal specs, and pull request guidelines.
 
+All contributors are expected to follow the [Code of Conduct](CODE_OF_CONDUCT.md).
+
+---
+
+## Code of Conduct
+
+This project follows the [Contributor Covenant](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this standard.
+
+---
+
+## Security
+
+To report a security vulnerability, use [GitHub's private vulnerability reporting](https://github.com/rahulkaushal04/plotstyle/security/advisories/new) rather than opening a public issue. See [SECURITY.md](SECURITY.md) for scope, timeline, and disclosure guidelines.
+
 ---
 
 ## Citation
 
-If PlotStyle helps your research, a citation or star is appreciated:
+If PlotStyle helps your research, a citation or star is appreciated.
 
-```bibtex
-@misc{plotstyle,
-  author  = {Kaushal, Rahul},
-  title   = {PlotStyle: Publication-ready scientific figure presets for Matplotlib},
-  year    = {2026},
-  url     = {https://github.com/rahulkaushal04/plotstyle},
-  note    = {Version 1.2.1},
-}
-```
+Use the **"Cite this repository"** button on the GitHub sidebar to get a ready-to-use APA or BibTeX entry. It reads from [`CITATION.cff`](CITATION.cff) and is always up to date.
 
 ---
 

{plotstyle-1.2.1 → plotstyle-1.2.3}/src/plotstyle/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.2.1'
-__version_tuple__ = version_tuple = (1, 2, 1)
+__version__ = version = '1.2.3'
+__version_tuple__ = version_tuple = (1, 2, 3)
 
 __commit_id__ = commit_id = None

{plotstyle-1.2.1 → plotstyle-1.2.3}/src/plotstyle/cli/main.py

@@ -82,6 +82,8 @@ def _cmd_info(journal: str) -> int:
     print("Typography:")
     print(f"  Font:          {fonts} (fallback: {typo.font_fallback})")
     print(f"  Size range:    {typo.min_font_pt}-{typo.max_font_pt}pt")
+    if typo.target_font_pt is not None:
+        print(f"  Target size:   {typo.target_font_pt}pt")
     print(
         f"  Panel labels:  {typo.panel_label_pt}pt "
         f"{typo.panel_label_weight} {typo.panel_label_case} "

{plotstyle-1.2.1 → plotstyle-1.2.3}/src/plotstyle/color/_rendering.py

@@ -30,9 +30,8 @@ def _fig_to_rgb_array(fig: Figure) -> NDArray[np.uint8]:
     """
     fig.canvas.draw()
 
-    # get_width_height() reads actual canvas pixel dimensions; avoids
-    # off-by-one from float rounding in int(fig_in * dpi).
-    width, height = fig.canvas.get_width_height()
+    # physical=True matches the buffer_rgba() byte count on HiDPI/Retina screens.
+    width, height = fig.canvas.get_width_height(physical=True)
 
     # buffer_rgba() returns a read-only memoryview; .copy() makes it writeable
     rgba = np.frombuffer(fig.canvas.buffer_rgba(), dtype=np.uint8).reshape(height, width, 4)

{plotstyle-1.2.1 → plotstyle-1.2.3}/src/plotstyle/core/style.py

@@ -771,6 +771,14 @@ def use(
     if journal_key is not None:
         spec = registry.get(journal_key)
         params = build_rcparams(spec, latex=effective_latex)
+
+        from cycler import cycler as _cycler
+
+        from plotstyle.color.palettes import JOURNAL_PALETTE_MAP, load_palette
+
+        _palette_name = JOURNAL_PALETTE_MAP.get(journal_key)
+        if _palette_name:
+            params["axes.prop_cycle"] = _cycler("color", load_palette(_palette_name))
     else:
         spec = None
         use_latex = _resolve_latex_mode(effective_latex)

{plotstyle-1.2.1 → plotstyle-1.2.3}/src/plotstyle/engine/rcparams.py

@@ -174,7 +174,13 @@ def build_rcparams(
         font_name = spec.typography.font_fallback
 
     figsize = _compute_figure_size(spec)
-    font_size = _compute_base_font_size(spec)
+    # Use the journal's explicit target when available; fall back to the
+    # midpoint heuristic for specs that only publish a compliance range.
+    font_size = (
+        spec.typography.target_font_pt
+        if spec.typography.target_font_pt is not None
+        else _compute_base_font_size(spec)
+    )
 
     params: dict[str, Any] = {
         "pdf.fonttype": _FONTTYPE_TRUETYPE,
@@ -194,12 +200,25 @@ def build_rcparams(
             "xtick.labelsize": font_size,
             "ytick.labelsize": font_size,
             "legend.fontsize": font_size,
-            # Clamped to physically reproducible minimums; thinner lines vanish in print.
             "lines.linewidth": max(spec.line.min_weight_pt, 1.0),
             "axes.linewidth": max(spec.line.min_weight_pt, 0.5),
-            # "none" keeps text editable in SVG; "path" converts to outlines (more portable).
             "svg.fonttype": "none" if spec.export.editable_text else "path",
             "axes.grid": False,
+            "legend.frameon": False,
+            "xtick.direction": "in",
+            "xtick.major.size": 3.0,
+            "xtick.major.width": 0.5,
+            "xtick.minor.size": 1.5,
+            "xtick.minor.width": 0.5,
+            "xtick.minor.visible": True,
+            "xtick.top": True,
+            "ytick.direction": "in",
+            "ytick.major.size": 3.0,
+            "ytick.major.width": 0.5,
+            "ytick.minor.size": 1.5,
+            "ytick.minor.width": 0.5,
+            "ytick.minor.visible": True,
+            "ytick.right": True,
         }
     )
 

{plotstyle-1.2.1 → plotstyle-1.2.3}/src/plotstyle/preview/gallery.py

@@ -69,7 +69,7 @@ def _draw_line_panel(ax: Axes) -> None:
         ax.plot(x, y, label=f"Series {i + 1}")
     ax.set_xlabel("x")
     ax.set_ylabel("y")
-    ax.legend(fontsize="small")
+    ax.legend(fontsize="small", loc="upper right")
     ax.set_title("Line Plot", fontsize="small")
 
 
@@ -81,7 +81,7 @@ def _draw_scatter_panel(ax: Axes) -> None:
         ax.scatter(x[mask], y[mask], label=str(group_label), s=15, alpha=0.8)
     ax.set_xlabel("x")
     ax.set_ylabel("y")
-    ax.legend(fontsize="small")
+    ax.legend(fontsize="small", loc="lower right")
     ax.set_title("Scatter Plot", fontsize="small")
 
 

{plotstyle-1.2.1 → plotstyle-1.2.3}/src/plotstyle/specs/nature.toml

@@ -15,6 +15,7 @@ font_family = ["Helvetica", "Arial"]
 font_fallback = "sans-serif"
 min_font_pt = 5.0
 max_font_pt = 7.0
+target_font_pt = 7.0
 
 [export]
 preferred_formats = ["ai", "eps", "pdf"]