plot-io 0.1.0__py3-none-any.whl

plot_io/styles/library.py

@@ -0,0 +1,732 @@
+"""Bundled styles: the defaults of common plotting libraries, in plot_io's settings.
+
+Lengths are points (CSS px × 0.75; R's ggplot2 linewidth L mm → L × 72.27 / 25.4 × 0.75
+pt). The source of every value is listed in the plan's reference sheet.
+"""
+
+from . import register_style
+
+#: An open "+" (two strokes): matplotlib's and MATLAB's outlier marker
+_PLUS = "M-0.5 0 H0.5 M0 -0.5 V0.5"
+
+register_style("default", {})
+
+# -- matplotlib (rcParams defaults, ≥ 2.0) --------------------------------------------
+
+register_style("matplotlib", {
+    "font_family": "DejaVu Sans, Bitstream Vera Sans, Arial, Helvetica, sans-serif",
+    "font_size": 10.0,
+    "text_color": "black",
+    "line_width": 1.5,
+    "palette": "tab10",
+    "color_map": "viridis",
+    "Figure.background": "white",
+    "Plot.spines": "all",
+    "Title.pad": 6.0,
+    "FigureTitle.font_size": 12.0,            # suptitle: "large", normal weight
+    "FigureTitle.font_weight": "normal",
+    "Axis.line_width": 0.8,
+    "Axis.tick_length": 3.5,
+    "Axis.minor_tick_length": 2.0,
+    "Axis.tick_width": 0.8,
+    "Axis.tick_pad": 3.5,
+    "Axis.label_pad": 4.0,
+    "Axis.grid_color": "#b0b0b0",
+    "Axis.grid_width": 0.8,
+    "Legend.frame": True,
+    "Legend.frame_color": "#cccccc",
+    "Legend.frame_width": 1.0,
+    "Legend.frame_alpha": 0.8,
+    "Legend.frame_radius": 3.0,
+    "Legend.row_height": 1.5,
+    "Scatter.size": 6.0,
+    "Line.marker_size": 6.0,
+    "Box.color": "none",
+    "Box.line_color": "black",
+    "Box.line_width": 1.0,
+    "Box.median_color": "C1",
+    "Box.median_width": 1.0,
+    "Box.width": 0.5,
+    "Box.marker_color": "none",
+    "Box.marker_line_color": "black",
+    "Box.marker_line_width": 1.0,
+    "Box.marker_size": 6.0,
+    "Colorbar.frame": True,
+    "Colorbar.frame_color": "black",
+    "Colorbar.frame_width": 0.8,
+})
+
+register_style("matplotlib-classic", {
+    "base": "matplotlib",
+    "font_size": 12.0,
+    "line_width": 1.0,
+    "palette": "matplotlib_classic",
+    "color_map": "jet",
+    "Title.pad": 5.0,
+    "Axis.line_width": 1.0,
+    "Axis.tick_length": 4.0,
+    "Axis.tick_width": 0.5,
+    "Axis.tick_direction": "in",
+    "Axis.mirror": True,
+    "Axis.tick_pad": 4.0,
+    "Axis.label_pad": 5.0,
+    "Axis.padding": 0.0,
+    "Axis.nice": True,
+    "Legend.position": "top right",
+    "Legend.frame_color": "black",
+    "Legend.frame_alpha": 1.0,
+    "Legend.frame_radius": 0.0,
+    "Scatter.size": 4.47,
+    "Scatter.line_color": "black",
+    "Scatter.line_width": 0.5,
+    "Box.line_color": "#0000ff",
+    "Box.median_color": "#ff0000",
+    "Box.whisker_style": "dashed",
+    "Box.marker": _PLUS,
+    "Box.marker_color": "#0000ff",
+    "Box.marker_filled": False,
+    "Box.marker_line_width": 1.0,
+    "Box.size_basis": "box",
+})
+
+# -- seaborn (0.13: axes_style, plotting_context "notebook", "deep") ---------------------
+
+register_style("seaborn", {
+    "font_family": "Arial, DejaVu Sans, Liberation Sans, Bitstream Vera Sans, sans-serif",
+    "font_size": 12.0,
+    "text_color": "#262626",
+    "line_width": 1.5,
+    "palette": "deep",
+    "color_map": "rocket",
+    "Figure.background": "white",
+    "Plot.background": "#EAEAF2",
+    "Plot.spines": "none",
+    "Title.font_size": 12.0,
+    "Title.pad": 6.0,
+    "FigureTitle.font_size": 14.4,
+    "FigureTitle.font_weight": "normal",
+    "Axis.tick_size": 11.0,
+    "Axis.tick_length": 0.0,
+    "Axis.tick_pad": 3.5,
+    "Axis.label_pad": 4.0,
+    "Axis.line_width": 1.25,
+    "Axis.grid": True,
+    "Axis.grid_color": "white",
+    "Axis.grid_width": 1.0,
+    "Legend.font_size": 11.0,
+    "Legend.frame": True,
+    "Legend.frame_color": "#cccccc",
+    "Legend.frame_width": 1.0,
+    "Legend.frame_alpha": 0.8,
+    "Legend.frame_radius": 3.0,
+    "Legend.row_height": 1.5,
+    "Scatter.size": 6.0,
+    "Scatter.line_color": "white",
+    "Scatter.line_width": 0.48,
+    "Line.marker_size": 6.0,
+    "Box.saturation": 0.75,
+    "Box.line_color": "auto",
+    "Box.line_width": 1.0,
+    "Box.median_width": 1.0,
+    "Box.marker_color": "none",
+    "Box.marker_line_width": 1.0,
+    "Box.marker_size": 5.0,
+})
+
+register_style("seaborn-darkgrid", {"base": "seaborn"})
+register_style("seaborn-whitegrid", {
+    "base": "seaborn",
+    "Plot.background": "white",
+    "Plot.spines": "all",
+    "Axis.line_color": "#cccccc",
+    "Axis.grid_color": "#cccccc",
+})
+register_style("seaborn-dark", {"base": "seaborn", "Axis.grid": False})
+register_style("seaborn-white", {
+    "base": "seaborn",
+    "Plot.background": "white",
+    "Plot.spines": "all",
+    "Axis.grid": False,
+})
+register_style("seaborn-ticks", {
+    "base": "seaborn-white",
+    "Axis.tick_length": 6.0,
+    "Axis.minor_tick_length": 4.0,
+    "Axis.tick_width": 1.25,
+})
+register_style("seaborn-paper", {"base": "seaborn", "Figure.scaling": 0.8})
+register_style("seaborn-talk", {"base": "seaborn", "Figure.scaling": 1.5})
+register_style("seaborn-poster", {"base": "seaborn", "Figure.scaling": 2.0})
+
+# -- ggplot2 (theme_grey(base_size = 11), hue_pal, scale_colour_gradient) -----------------
+
+_GG_LINE = 0.5 * 72.27 / 25.4 * 0.75          # base_line_size 0.5 mm → 1.07 pt
+
+register_style("ggplot2", {
+    "font_family": "Helvetica, Arial, Liberation Sans, sans-serif",
+    "font_size": 11.0,
+    "text_color": "black",
+    "line_width": _GG_LINE,
+    "palette": "hue",
+    "color_map": "ggplot2",
+    "Figure.background": "white",
+    "Plot.background": "#EBEBEB",
+    "Plot.spines": "none",
+    "Title.font_size": 13.2,
+    "Title.align": "left",
+    "Title.pad": 5.5,
+    "FigureTitle.font_size": 13.2,
+    "FigureTitle.font_weight": "normal",
+    "FigureTitle.align": "left",
+    "Axis.tick_size": 8.8,
+    "Axis.tick_label_color": "#4D4D4D",
+    "Axis.tick_color": "#333333",
+    "Axis.tick_length": 2.75,
+    "Axis.tick_width": _GG_LINE,
+    "Axis.tick_pad": 2.2,
+    "Axis.label_pad": 2.75,
+    "Axis.grid": True,
+    "Axis.grid_color": "white",
+    "Axis.grid_width": _GG_LINE,
+    "Axis.minor_grid": True,
+    "Axis.minor_grid_width": _GG_LINE / 2,
+    "Legend.position": "outside right",
+    "Legend.font_size": 8.8,
+    "Legend.glyph_width": 1.8,
+    "Legend.row_height": 1.8,
+    "Legend.pad": 11.0,
+    "Scatter.size": 4.3,
+    "Line.marker_size": 4.3,
+    "Box.color": "white",
+    "Box.line_color": "#333333",
+    "Box.line_width": _GG_LINE,
+    "Box.median_width": 2 * _GG_LINE,
+    "Box.width": 0.75,
+    "Box.cap_width": 0.0,
+    "Box.marker_color": "black",
+    "Box.marker_size": 4.3,
+    "Colorbar.tick_color": "white",           # guide_colourbar: white ticks inside
+    "Colorbar.tick_direction": "in",
+    "Colorbar.tick_length": 2.0,
+    "Colorbar.mirror": True,
+})
+
+register_style("ggplot2-bw", {
+    "base": "ggplot2",
+    "Plot.background": "white",
+    "Plot.border": "#333333",
+    "Plot.border_width": _GG_LINE,
+    "Axis.grid_color": "#EBEBEB",
+})
+register_style("ggplot2-light", {
+    "base": "ggplot2",
+    "Plot.background": "white",
+    "Plot.border": "#B3B3B3",
+    "Plot.border_width": _GG_LINE,
+    "Axis.grid_color": "#DEDEDE",
+    "Axis.grid_width": _GG_LINE / 2,
+    "Axis.minor_grid_width": _GG_LINE / 4,
+    "Axis.tick_color": "#B3B3B3",
+    "Axis.tick_width": _GG_LINE / 2,
+})
+register_style("ggplot2-minimal", {
+    "base": "ggplot2",
+    "Plot.background": "white",
+    "Axis.grid_color": "#EBEBEB",
+    "Axis.tick_length": 0.0,
+    "Axis.tick_pad": 4.95,
+})
+register_style("ggplot2-classic", {
+    "base": "ggplot2",
+    "Plot.background": "white",
+    "Plot.spines": "left bottom",
+    "Axis.line_color": "black",
+    "Axis.line_width": _GG_LINE,
+    "Axis.tick_color": "black",
+    "Axis.grid": False,
+    "Axis.minor_grid": False,
+})
+
+# -- altair (Vega-Lite / Vega default config) -------------------------------------------
+
+register_style("altair", {
+    "font_family": "sans-serif",
+    "font_size": 7.5,                         # guide-label 10 px
+    "text_color": "black",
+    "line_width": 1.5,                        # line strokeWidth 2 px
+    "palette": "tableau10",
+    "color_map": "ylgnbu",
+    "Figure.background": "white",
+    "Plot.border": "#DDDDDD",                 # view stroke
+    "Plot.border_width": 0.75,
+    "Title.font_size": 9.75,                  # group-title 13 px bold
+    "Title.font_weight": "bold",
+    "Title.pad": 3.0,
+    "FigureTitle.font_size": 9.75,
+    "Axis.label_size": 8.25,                  # guide-title 11 px bold
+    "Axis.label_weight": "bold",
+    "Axis.line_color": "#888888",
+    "Axis.line_width": 0.75,
+    "Axis.tick_color": "#888888",
+    "Axis.tick_length": 3.75,
+    "Axis.tick_width": 0.75,
+    "Axis.tick_pad": 1.5,
+    "Axis.label_pad": 3.0,
+    "Axis.grid": True,
+    "Axis.grid_color": "#DDDDDD",
+    "Axis.grid_width": 0.75,
+    "Axis.padding": 0.0,
+    "Axis.nice": True,
+    "Axis.include_zero": "auto",
+    "Legend.position": "outside right",
+    "Legend.pad": 13.5,
+    "Scatter.size": 4.6,                      # point size 30 px², stroke 2 px, not filled
+    "Scatter.filled": False,
+    "Scatter.line_width": 1.5,
+    "Line.marker_size": 4.6,
+    "Box.line_color": "black",
+    "Box.line_width": 0.75,
+    "Box.median_color": "white",
+    "Box.median_width": 1.5,
+    "Box.width": 0.5,
+    "Box.marker_filled": False,
+    "Box.marker_line_width": 1.5,
+    "Box.marker_size": 4.6,
+})
+
+# -- MATLAB (R2014b+ default property values) -------------------------------------------
+
+register_style("matlab", {
+    "font_family": "Helvetica, Arial, Liberation Sans, sans-serif",
+    "font_size": 10.0,
+    "text_color": "#262626",
+    "line_width": 0.5,
+    "palette": "matlab",
+    "color_map": "parula",
+    "Figure.background": "white",
+    "Title.font_size": 11.0,
+    "Title.font_weight": "bold",
+    "Title.pad": 5.0,
+    "FigureTitle.font_size": 11.0,            # sgtitle
+    "FigureTitle.font_weight": "normal",
+    "Axis.label_size": 11.0,
+    "Axis.line_width": 0.5,
+    "Axis.tick_direction": "in",
+    "Axis.tick_length": 3.2,
+    "Axis.tick_width": 0.5,
+    "Axis.grid_color": "#dbdbdb",
+    "Axis.padding": 0.0,
+    "Axis.nice": True,
+    "Legend.position": "top right",
+    "Legend.font_size": 9.0,
+    "Legend.frame": True,
+    "Legend.frame_color": "#262626",
+    "Legend.frame_width": 0.5,
+    "Scatter.size": 6.0,
+    "Scatter.filled": False,
+    "Scatter.line_width": 0.5,
+    "Line.marker_size": 6.0,
+    "Box.color": "none",
+    "Box.line_color": "#0000ff",
+    "Box.line_width": 0.5,
+    "Box.median_color": "#ff0000",
+    "Box.median_width": 0.5,
+    "Box.whisker_color": "black",
+    "Box.whisker_style": "dashed",
+    "Box.width": 0.5,
+    "Box.marker": _PLUS,
+    "Box.marker_color": "#ff0000",
+    "Box.marker_filled": False,
+    "Box.marker_line_width": 0.5,
+    "Box.marker_size": 6.0,
+    "Box.size_basis": "box",
+    "Colorbar.frame": True,
+    "Colorbar.frame_color": "#262626",
+})
+
+register_style("matlab-box", {"base": "matlab", "Plot.spines": "all", "Axis.mirror": True})
+
+# -- Chart.js 4 (core defaults, colors plugin) ------------------------------------------
+
+register_style("chartjs", {
+    "font_family": "Helvetica Neue, Helvetica, Arial, sans-serif",
+    "font_size": 9.0,                         # 12 px
+    "text_color": "#666666",
+    "line_width": 2.25,                       # line borderWidth 3 px
+    "palette": "chartjs",
+    "Figure.background": "white",
+    "Title.font_size": 9.0,
+    "Title.font_weight": "bold",
+    "Title.pad": 7.5,
+    "FigureTitle.font_size": 9.0,
+    "Axis.line_color": "#0000001A",
+    "Axis.line_width": 0.75,
+    "Axis.tick_color": "#0000001A",
+    "Axis.tick_length": 6.0,                  # tickLength 8 px
+    "Axis.tick_width": 0.75,
+    "Axis.tick_pad": 2.25,
+    "Axis.grid": True,
+    "Axis.grid_color": "#0000001A",
+    "Axis.grid_width": 0.75,
+    "Legend.position": "outside top",
+    "Legend.glyph": "box",
+    "Legend.glyph_alpha": 0.5,
+    "Legend.glyph_width": 3.33,               # boxWidth 40 px
+    "Legend.row_height": 1.67,
+    "Legend.pad": 7.5,
+    "Scatter.size": 4.5,                      # radius 3 px
+    "Scatter.filled": 0.5,                    # background: the color at 0.5
+    "Scatter.line_width": 0.75,
+    "Line.show_markers": True,
+    "Line.marker_size": 4.5,
+    "Line.marker_filled": 0.5,
+    "Line.marker_line_width": 0.75,
+    "Fill.alpha": 0.5,
+    "Box.alpha": 0.5,
+    "Box.line_color": "#666666",
+    "Box.line_width": 0.75,
+    "Box.median_width": 1.5,
+})
+
+# -- plotly (plotly.py "plotly" and "plotly_white" templates, plotly.js defaults) --------
+
+register_style("plotly", {
+    "font_family": "Open Sans, verdana, arial, sans-serif",
+    "font_size": 9.0,                         # 12 px
+    "text_color": "#2a3f5f",
+    "line_width": 1.5,                        # 2 px
+    "palette": "plotly",
+    "color_map": "plasma",
+    "Figure.background": "white",
+    "Plot.background": "#E5ECF6",
+    "Plot.spines": "none",
+    "Title.font_size": 12.75,                 # 17 px
+    "Title.align": "left",
+    "Title.over": "plot",
+    "Title.pad": 7.5,
+    "FigureTitle.font_size": 12.75,
+    "FigureTitle.font_weight": "normal",
+    "FigureTitle.align": "left",
+    "FigureTitle.over": "figure",
+    "Axis.tick_length": 0.0,
+    "Axis.tick_pad": 4.0,
+    "Axis.label_pad": 6.0,
+    "Axis.grid": True,
+    "Axis.grid_color": "white",
+    "Axis.grid_width": 0.75,
+    "Axis.zero_line": True,
+    "Axis.zero_line_color": "white",
+    "Axis.zero_line_width": 1.5,
+    "Legend.position": "outside right",
+    "Legend.pad": 7.5,
+    "Scatter.size": 4.5,                      # 6 px
+    "Line.marker_size": 4.5,
+    "Box.alpha": 0.5,
+    "Box.line_color": "series",
+    "Box.line_width": 1.5,
+    "Box.median_width": 1.5,
+    "Box.width": 0.5,
+    "Box.cap_width": 0.0,
+    "Box.marker_size": 4.5,
+})
+
+register_style("plotly-white", {
+    "base": "plotly",
+    "Plot.background": "white",
+    "Axis.grid_color": "#EBF0F8",
+    "Axis.zero_line_color": "#EBF0F8",
+})
+
+# -- Bokeh (3.x model defaults) ---------------------------------------------------------
+
+register_style("bokeh", {
+    "font_family": "Helvetica, Arial, Liberation Sans, sans-serif",
+    "font_size": 8.25,                        # major labels 11 px
+    "text_color": "#444444",
+    "line_width": 0.75,                       # 1 px
+    "palette": "tab10",                       # Category10
+    "color_map": "viridis",
+    "Figure.background": "white",
+    "Plot.border": "#e5e5e5",                 # outline_line_color
+    "Plot.border_width": 0.75,
+    "Title.font_size": 9.75,                  # 13 px bold, left
+    "Title.font_weight": "bold",
+    "Title.align": "left",
+    "FigureTitle.font_size": 9.75,
+    "FigureTitle.align": "left",
+    "Axis.label_size": 9.75,                  # 13 px italic
+    "Axis.label_style": "italic",
+    "Axis.color": "black",
+    "Axis.tick_label_color": "#444444",
+    "Axis.label_color": "#444444",
+    "Axis.line_width": 0.75,
+    "Axis.tick_width": 0.75,
+    "Axis.tick_length": 4.5,                  # major_tick_out 6 px
+    "Axis.minor_tick_length": 3.0,            # minor_tick_out 4 px
+    "Axis.minor_ticks": True,
+    "Axis.tick_pad": 3.75,                    # major_label_standoff 5 px
+    "Axis.label_pad": 3.75,                   # axis_label_standoff 5 px
+    "Axis.grid": True,
+    "Axis.grid_color": "#e5e5e5",
+    "Axis.grid_width": 0.75,
+    "Legend.position": "top right",
+    "Legend.frame": True,
+    "Legend.frame_color": "#00000080",        # black, alpha 0.5
+    "Legend.frame_alpha": 0.95,
+    "Legend.frame_width": 0.75,
+    "Legend.font_size": 9.75,                 # 13 px
+    "Legend.glyph_width": 1.54,               # 20 px glyphs
+    "Legend.row_height": 1.54,
+    "Scatter.size": 3.0,                      # size 4 px
+})
+
+# -- Observable Plot (defaults of @observablehq/plot) -----------------------------------
+
+register_style("observable", {
+    "font_family": "system-ui, sans-serif",
+    "font_size": 7.5,                         # 10 px
+    "text_color": "black",
+    "line_width": 1.125,                      # 1.5 px
+    "palette": "observable10",
+    "color_map": "turbo",
+    "Figure.background": "white",
+    "Plot.spines": "none",
+    "Axis.tick_length": 4.5,                  # tickSize 6 px
+    "Axis.tick_width": 0.75,
+    "Axis.tick_pad": 2.25,                    # tickPadding 3 px
+    "Legend.position": "outside top",
+    "Legend.glyph": "box",                    # square swatches
+    "Legend.glyph_width": 1.2,
+    "Legend.row_height": 1.5,
+    "Scatter.size": 4.5,                      # r 3 px, not filled, stroke 1.5 px
+    "Scatter.filled": False,
+    "Scatter.line_width": 1.125,
+    "Box.color": "#cccccc",
+    "Box.line_color": "black",
+    "Box.line_width": 0.75,
+    "Box.median_width": 1.5,
+    "Box.width": 0.6,
+    "Box.cap_width": 0.0,
+    "Box.marker_color": "black",
+    "Box.marker_size": 2.25,
+})
+
+# -- Excel (2013+ default chart, Office 2013 theme) -------------------------------------
+
+register_style("excel", {
+    "font_family": "Carlito, Calibri, Liberation Sans, sans-serif",
+    "font_size": 9.0,
+    "text_color": "#595959",
+    "line_width": 2.25,
+    "palette": "office",
+    "Figure.background": "white",
+    "Plot.spines": "bottom",
+    "Title.font_size": 14.0,
+    "FigureTitle.font_size": 14.0,
+    "FigureTitle.font_weight": "normal",
+    "Axis.line_color": "#D9D9D9",
+    "Axis.line_width": 0.75,
+    "Axis.tick_length": 0.0,
+    "Axis.tick_pad": 4.0,
+    "YAxis.grid": True,
+    "Axis.grid_color": "#D9D9D9",
+    "Axis.grid_width": 0.75,
+    "Legend.position": "outside bottom",
+    "Scatter.size": 5.0,
+    "Box.line_color": "#595959",
+    "Box.line_width": 0.75,
+    "Box.median_width": 0.75,
+    "Box.mean": True,
+    "Box.mean_marker": "cross",
+    "Box.mean_color": "#595959",
+})
+
+# -- FiveThirtyEight (matplotlib's fivethirtyeight style) --------------------------------
+
+register_style("fivethirtyeight", {
+    "base": "matplotlib",
+    "font_size": 14.0,
+    "line_width": 4.0,
+    "palette": "fivethirtyeight",
+    "Figure.background": "#f0f0f0",
+    "Plot.background": "#f0f0f0",
+    "Plot.spines": "none",
+    "Title.font_size": 20.16,                 # x-large
+    "FigureTitle.font_size": 20.16,
+    "Axis.label_size": 16.8,                  # large
+    "Axis.tick_length": 0.0,
+    "Axis.grid": True,
+    "Axis.grid_color": "#cbcbcb",
+    "Axis.grid_width": 1.0,
+    "Legend.background": "#f0f0f0",
+    "Box.color": "none",
+    "Colorbar.frame": False,
+})
+
+# -- The Economist (ggthemes theme_economist, base_size 10) -----------------------------
+
+_EC_LINE = 0.5 * 72.27 / 25.4 * 0.75          # ggplot2 linewidth 0.5 mm
+
+register_style("economist", {
+    "font_family": "Helvetica, Arial, Liberation Sans, sans-serif",
+    "font_size": 10.0,
+    "text_color": "black",
+    "line_width": _EC_LINE,
+    "palette": "economist",
+    "Figure.background": "#d5e4eb",
+    "Figure.title_rule": "#ed111a",
+    "Plot.background": "#d5e4eb",
+    "Plot.spines": "bottom",
+    "Title.font_size": 15.0,
+    "Title.font_weight": "bold",
+    "Title.align": "left",
+    "FigureTitle.font_size": 15.0,
+    "FigureTitle.align": "left",
+    "Axis.line_width": 0.8 * _EC_LINE,
+    "Axis.tick_direction": "in",
+    "Axis.tick_length": 5.0,
+    "Axis.tick_width": _EC_LINE,
+    "Axis.tick_pad": 5.0,
+    "YAxis.side": "right",
+    "YAxis.tick_length": 0.0,
+    "YAxis.grid": True,
+    "Axis.grid_color": "white",
+    "Axis.grid_width": 1.75 * _EC_LINE,
+    "Legend.position": "outside top",
+    "Legend.font_size": 12.5,
+    "Scatter.size": 4.3,
+    "Box.color": "#6794a7",
+    "Box.line_color": "black",
+    "Box.line_width": _EC_LINE,
+    "Box.cap_width": 0.0,
+})
+
+# -- Tufte (ggthemes theme_tufte, with a range frame) -----------------------------------
+
+register_style("tufte", {
+    "font_family": "serif",
+    "font_size": 11.0,
+    "text_color": "black",
+    "line_width": 0.5,
+    "palette": "greys",
+    "color_map": "grey_r",
+    "Figure.background": "white",
+    "Title.font_size": 13.2,
+    "Title.align": "left",
+    "FigureTitle.font_weight": "normal",
+    "FigureTitle.align": "left",
+    "Axis.tick_size": 8.8,
+    "Axis.tick_label_color": "#4D4D4D",
+    "Axis.tick_color": "#333333",
+    "Axis.line_color": "#333333",
+    "Axis.line_width": 0.5,
+    "Axis.tick_length": 2.75,
+    "Axis.tick_width": 0.5,
+    "Axis.spine_trim": True,
+    "Axis.spine_offset": 5.0,
+    "Legend.position": "outside right",
+    "Scatter.size": 4.0,
+    "Box.color": "none",
+    "Box.line_color": "black",
+    "Box.line_width": 0.5,
+    "Box.width": 0.3,
+    "Box.cap_width": 0.0,
+    "Box.median_width": 0.5,
+    "Box.marker_color": "black",
+    "Box.marker_size": 2.0,
+})
+
+
+# -- the plot types of plan 3 ----------------------------------------------------------
+# matplotlib and seaborn values read from the installed libraries' artists; the others from
+# their documented defaults (sources in the plan's reference sheet).
+
+def _extend(name: str, keys: dict) -> None:
+    from . import _STYLES
+    register_style(name, {**_STYLES[name], **keys})
+
+
+_extend("matplotlib", {
+    "Kde.line_width": 1.5,
+    "Ecdf.line_width": 1.5,
+    "Violin.alpha": 0.3,                      # violinplot bodies: C0 at 0.3, no edge
+    "Violin.line_width": 0.0,
+    "Violin.inner": False,
+    "Strip.size": 6.0,
+    "Swarm.size": 6.0,
+    "Pie.line_width": 0.0,                    # wedges without edges
+})
+_extend("seaborn", {
+    "Bar.saturation": 0.75,                   # barplot: saturation .75, white 1 pt edges
+    "Bar.line_color": "white",
+    "Bar.line_width": 1.0,
+    "Bar.error_color": "#424242",
+    "Hist.alpha": 0.75,                       # histplot: alpha .75, white edges
+    "Hist.line_color": "white",
+    "Hist.line_width": 1.0,
+    "Kde.line_width": 1.5,
+    "Ecdf.line_width": 1.5,
+    "Violin.saturation": 0.75,                # violinplot: edges and inner box #4c4c4c
+    "Violin.line_color": "#4c4c4c",
+    "Violin.line_width": 1.25,
+    "Strip.size": 5.0,                        # stripplot/swarmplot: s=25, no edge
+    "Strip.line_width": 0.0,
+    "Swarm.size": 5.0,
+    "Swarm.line_width": 0.0,
+    "Regression.line_width": 2.25,            # regplot: lw 1.5 × 1.5, band alpha .15
+    "Regression.band_alpha": 0.15,
+    "Regression.marker_size": 6.0,
+})
+_extend("ggplot2", {
+    "Hist.line_width": 0.0,
+    "Kde.line_width": 1.067,                  # geom_density: black, linewidth 0.5
+    "Violin.color": "white",                  # geom_violin: white fill, grey20 outline
+    "Violin.line_color": "#333333",
+    "Violin.line_width": 1.067,
+    "Violin.inner": False,
+    "Regression.color": "#3366FF",            # geom_smooth: #3366FF, linewidth 1
+    "Regression.line_width": 2.134,
+    "Regression.band_alpha": 0.4,
+    "Area.alpha": 1.0,
+})
+_extend("altair", {
+    "Bar.width": 0.9,                         # band scale paddingInner 0.1
+    "Hist.line_color": "white",               # binSpacing 1 px
+    "Hist.line_width": 0.75,
+    "Area.alpha": 0.7,
+    "Pie.line_width": 0.0,
+})
+_extend("matlab", {
+    "Bar.line_color": "black",                # bar: black 0.5 edges
+    "Bar.line_width": 0.5,
+    "Hist.alpha": 0.6,                        # histogram: FaceAlpha 0.6, black edges
+    "Hist.line_color": "black",
+    "Hist.line_width": 0.5,
+    "Pie.line_color": "black",
+    "Pie.line_width": 0.5,
+})
+_extend("chartjs", {
+    "Bar.width": 0.72,                        # categoryPercentage 0.8 × barPercentage 0.9
+    "Bar.alpha": 0.5,                         # default colors: background at 0.5
+    "Pie.line_width": 1.5,                    # 2 px white borders
+})
+_extend("plotly", {
+    "Bar.line_color": "#E5ECF6",              # template: marker line #E5ECF6, 0.5 px
+    "Bar.line_width": 0.375,
+    "Hist.line_color": "#E5ECF6",
+    "Hist.line_width": 0.375,
+    "Pie.line_width": 0.0,
+})
+_extend("excel", {
+    "Bar.width": 0.48,                        # gap width 219 % (two series: 2 / 4.19)
+    "Pie.line_color": "white",
+    "Pie.line_width": 0.75,
+})
+_extend("fivethirtyeight", {
+    "Bar.line_color": "#f0f0f0",              # patch.edgecolor #f0f0f0, linewidth 0.5
+    "Bar.line_width": 0.5,
+    "Hist.line_color": "#f0f0f0",
+    "Hist.line_width": 0.5,
+    "Pie.line_color": "#f0f0f0",
+    "Pie.line_width": 0.5,
+})