"""Apply Config Example
=====================================

:func:`sysplot.apply_config` applies a seaborn-derived theme globally to all
subsequent Matplotlib figures. Font size, line width, x-margin, and seaborn
style can be customised via :class:`sysplot.SysplotConfig`, overridden
individually, or reset to defaults with :func:`sysplot.reset_config`.
"""

import matplotlib.pyplot as plt
import numpy as np
import sysplot as ssp

# Create and validate a custom configuration.
config = ssp.SysplotConfig(font_size=12, linewidth=1.5, seaborn_style="ticks")
config.validate()

# Apply the full config object.
ssp.apply_config(config=config)

# You can still override selected fields directly.
ssp.apply_config(xmargin=0.05)

# Inspect active values.
current = ssp.get_config()
print("active font_size:", current.font_size)
print("active xmargin:", current.xmargin)

x = np.linspace(0, 2 * np.pi, 200)
fig, ax = plt.subplots()
ax.plot(x, np.sin(x), label="sin(x)")
ax.plot(x, np.cos(x), label="cos(x)")
ax.set(title="apply_config()", xlabel="x", ylabel="y")
ax.legend()
plt.show()

# Optionally restore defaults for later plots.
ssp.reset_config()