plotstyle 1.2.2__tar.gz → 1.2.3__tar.gz

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

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

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

@@ -13,6 +13,30 @@ _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.
@@ -172,7 +196,8 @@ 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.2...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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotstyle
-Version: 1.2.2
+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)
 
@@ -415,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)")
@@ -424,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)")
@@ -660,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 |
 
 ---
 
@@ -668,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.2},
-}
-```
+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.2 → 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)
 
@@ -334,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)")
@@ -343,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)")
@@ -579,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 |
 
 ---
 
@@ -587,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.2},
-}
-```
+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.2 → 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.2'
-__version_tuple__ = version_tuple = (1, 2, 2)
+__version__ = version = '1.2.3'
+__version_tuple__ = version_tuple = (1, 2, 3)
 
 __commit_id__ = commit_id = None

{plotstyle-1.2.2 → 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.2 → 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.2 → 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.2 → 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.2 → 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"]

{plotstyle-1.2.2 → plotstyle-1.2.3}/src/plotstyle/specs/schema.py

@@ -538,6 +538,12 @@ class TypographySpec:
         Font weight for panel labels (e.g. ``"bold"``).
     panel_label_case : str
         Case transformation for panel labels (e.g. ``"lower"``, ``"upper"``).
+    target_font_pt : float | None
+        Recommended rendering font size in points, when the journal's
+        guidelines state a preferred target distinct from the midpoint of
+        ``[min_font_pt, max_font_pt]``.  ``None`` when absent from the TOML,
+        in which case ``build_rcparams`` falls back to the midpoint heuristic.
+        Must be within ``[min_font_pt, max_font_pt]`` when set.
     """
 
     font_family: list[str]
@@ -547,6 +553,7 @@ class TypographySpec:
     panel_label_pt: float
     panel_label_weight: str
     panel_label_case: str
+    target_font_pt: float | None = None
 
 
 @dataclass(frozen=True, slots=True)
@@ -872,6 +879,24 @@ class JournalSpec:
                 f"must be ≥ min_font_pt ({min_pt}), got {max_pt}",
             )
 
+        # target_font_pt is optional. When present it must be a non-negative
+        # float within the journal's compliance range [min_pt, max_pt].
+        target_pt: float | None = None
+        if "target_font_pt" in raw:
+            raw_target = raw["target_font_pt"]
+            try:
+                target_pt = float(raw_target)
+            except (TypeError, ValueError):
+                raise FieldTypeError(t, "target_font_pt", "float", raw_target) from None
+            if target_pt < 0.0:
+                raise FieldValueError(t, "target_font_pt", f"must be ≥ 0, got {target_pt}")
+            if not (min_pt <= target_pt <= max_pt):
+                raise FieldValueError(
+                    t,
+                    "target_font_pt",
+                    f"must be within [min_font_pt={min_pt}, max_font_pt={max_pt}], got {target_pt}",
+                )
+
         return TypographySpec(
             font_family=_cast_str_list(
                 raw,
@@ -890,6 +915,7 @@ class JournalSpec:
             panel_label_case=_cast_str(
                 raw, t, "panel_label_case", default="lower", allowed=_KNOWN_LABEL_CASES
             ),
+            target_font_pt=target_pt,
         )
 
     @staticmethod

{plotstyle-1.2.2 → plotstyle-1.2.3}/tests/test_core/test_style.py

@@ -740,6 +740,113 @@ class TestJournalStyleRestore:
 # ---------------------------------------------------------------------------
 
 
+# ===========================================================================
+# use(): journal color cycle
+# ===========================================================================
+
+
+class TestUseColorCycle:
+    """Verify that use() applies the journal-recommended default color cycle."""
+
+    @pytest.mark.filterwarnings("ignore::plotstyle._utils.warnings.SpecAssumptionWarning")
+    @pytest.mark.filterwarnings("ignore::plotstyle._utils.warnings.FontFallbackWarning")
+    def test_nature_gets_okabe_ito_palette(self) -> None:
+        """
+        Description: use('nature') must apply okabe_ito as the default color
+                     cycle. The JOURNAL_PALETTE_MAP maps 'nature' to okabe_ito.
+        Scenario: Call use('nature') and inspect axes.prop_cycle.
+        Expectation: The cycle colors match the okabe_ito palette.
+        """
+        from plotstyle.color.palettes import JOURNAL_PALETTE_MAP, load_palette
+
+        expected = load_palette(JOURNAL_PALETTE_MAP["nature"])
+        style = use("nature")
+        try:
+            actual = [item["color"] for item in mpl.rcParams["axes.prop_cycle"]]
+            assert actual == expected
+        finally:
+            style.restore()
+
+    @pytest.mark.filterwarnings("ignore::plotstyle._utils.warnings.SpecAssumptionWarning")
+    @pytest.mark.filterwarnings("ignore::plotstyle._utils.warnings.FontFallbackWarning")
+    def test_ieee_gets_safe_grayscale_palette(self) -> None:
+        """
+        Description: use('ieee') must apply safe_grayscale by default. IEEE
+                     requires colorblind-safe and grayscale-compatible figures;
+                     the matplotlib default blue-orange-green cycle would fail.
+        Scenario: Call use('ieee') and inspect axes.prop_cycle.
+        Expectation: The cycle colors match the safe_grayscale palette.
+        """
+        from plotstyle.color.palettes import JOURNAL_PALETTE_MAP, load_palette
+
+        expected = load_palette(JOURNAL_PALETTE_MAP["ieee"])
+        style = use("ieee")
+        try:
+            actual = [item["color"] for item in mpl.rcParams["axes.prop_cycle"]]
+            assert actual == expected
+        finally:
+            style.restore()
+
+    @pytest.mark.filterwarnings("ignore::plotstyle._utils.warnings.SpecAssumptionWarning")
+    @pytest.mark.filterwarnings("ignore::plotstyle._utils.warnings.FontFallbackWarning")
+    def test_color_overlay_overrides_default_palette(self) -> None:
+        """
+        Description: An explicit color overlay applied after use() must win
+                     over the journal's default palette. Overlay precedence
+                     must be preserved.
+        Scenario: use(['nature', 'tol-bright']) - tol-bright colors differ
+                  from nature's default okabe-ito.
+        Expectation: The cycle reflects tol-bright, not okabe-ito.
+        """
+        from plotstyle.color.palettes import load_palette
+
+        tol_bright = load_palette("tol_bright")
+        with use(["nature", "tol-bright"]) as _style:
+            actual = [item["color"] for item in mpl.rcParams["axes.prop_cycle"]]
+        assert actual == tol_bright
+
+    @pytest.mark.filterwarnings("ignore::plotstyle._utils.warnings.FontFallbackWarning")
+    def test_overlay_only_mode_does_not_apply_palette(self) -> None:
+        """
+        Description: When use() is called with overlays only (no journal key),
+                     no palette is applied from JOURNAL_PALETTE_MAP.
+        Scenario: use(['notebook']) - no journal key.
+        Expectation: axes.prop_cycle is unchanged from before the call.
+        """
+        before = list(mpl.rcParams["axes.prop_cycle"])
+        with use(["notebook"]):
+            after = list(mpl.rcParams["axes.prop_cycle"])
+        assert after == before
+
+
+# ===========================================================================
+# use(): font size target
+# ===========================================================================
+
+
+class TestUseFontSizeTarget:
+    """Verify that use('nature') applies 7 pt (target) not 6 pt (midpoint)."""
+
+    @pytest.mark.filterwarnings("ignore::plotstyle._utils.warnings.FontFallbackWarning")
+    def test_nature_font_size_is_7pt(self) -> None:
+        """
+        Description: Nature's TOML sets target_font_pt=7.0. build_rcparams
+                     must use 7 pt, not the 6 pt midpoint of the 5-7 pt range.
+        Scenario: use('nature') and read font.size.
+        Expectation: mpl.rcParams['font.size'] == 7.0.
+        """
+        style = use("nature")
+        try:
+            assert mpl.rcParams["font.size"] == pytest.approx(7.0)
+        finally:
+            style.restore()
+
+
+# ===========================================================================
+# Public API
+# ===========================================================================
+
+
 class TestPublicAPI:
     """Validate the module's public API surface."""