plot-io 0.2.0__tar.gz → 0.3.0__tar.gz

{plot_io-0.2.0 → plot_io-0.3.0}/API.md

@@ -33,7 +33,7 @@ Complete reference. Worked examples are in [EXAMPLES.md](EXAMPLES.md).
   sans-serif, black text, line width, `simplify="auto"`, the palette, …), and
   `"Class.name"` for the settings of each class. A class without an entry uses its base
   class's. Entries are plain data: a default that follows another setting is written
-  with units, `var()` or `calc()` (a plot title is `"1.2em"`, a minor tick `"60%"` of the
+  with units, `var()` or `calc()` (a legend's font is `"1em"`, a minor tick `"60%"` of the
   tick length, a fill's opacity `"calc(0.3 * var(alpha))"`). `None` and `"auto"` mean
   "chosen when drawing", as each setting's documentation says. `"XAxis.name"` and
   `"YAxis.name"` give one axis its own default.
@@ -57,6 +57,27 @@ Complete reference. Worked examples are in [EXAMPLES.md](EXAMPLES.md).
 * **Text.** Titles, axis labels and legend entries are strings or rich content: a list of
   strings and `pl.Span` (pdf_io's), e.g. `["Area (m", pl.Span("2",
   baseline_shift="super", font_scale=0.7), ")"]`.
+* **Named colors.** `"blue"`, `"blue 0.45"`, `"blue 45%"`: 28 scales (`red`, `orange`,
+  `amber`, `yellow`, `lime`, `green`, `emerald`, `teal`, `cyan`, `sky`, `blue`, `indigo`,
+  `violet`, `purple`, `fuchsia`, `pink`, `rose`, `slate`, `gray`/`grey`, `zinc`, `neutral`,
+  `stone`, `taupe`, `mauve`, `mist`, `olive`, `black`, `white`), Tailwind CSS 4's OKLCh
+  shades 100–900 at levels 0.1–0.9, white at 0 and black at 1, interpolated in Oklab between
+  and gamut mapped into sRGB as CSS Color 4 specifies;
+  a bare name is level 0.5. They take precedence over CSS's names (`"red"` is `#fb2c36`,
+  not `#ff0000`); other CSS names (`"navy"`) keep their CSS values. `get()` returns the
+  name as given, `resolve()` the hex color.
+* **Colors.** Named colors (above), any color pdf_io accepts: CSS names, `"#rrggbb[aa]"`, CSS Color 4 functions
+  (`"rgb(…)"`, `"hsl(…)"`, `"hwb(…)"`, `"lab(…)"`, `"lch(…)"`, `"oklab(…)"`,
+  `"oklch(64.5% 0.246 16.439)"`, `"color(display-p3 1 0 0)"`, …; colors outside sRGB are
+  gamut mapped as browsers do), tuples, `CMYK` and `Spot`; and `"C0"`, `"C1"`, … for the
+  palette's colors.
+* **Fonts.** `font_family` is a CSS family list; weights (`font_weight`, `label_weight`,
+  `tick_label_weight`) are `normal`, `bold` or 1–1000, styles `normal`, `italic`,
+  `oblique` or `"oblique 10deg"`. With a variable font (pdf_io embeds the instance used),
+  the weight sets `wght`, the inherited `font_stretch` (`"condensed"`, `"87.5%"`) sets
+  `wdth`, the style `ital` or `slnt`, `font_optical_sizing="auto"` sets `opsz` from the
+  font size, and `font_variations` (`{"GRAD": 50}`) any axis:
+  `pl.Figure(font_family="Roboto Flex", font_stretch="85%", font_variations={"GRAD": 50})`.
 * **Enums.** Enum-like settings take strings; `pl.Marker`, `pl.LineStyle`,
   `pl.Orientation`, `pl.Scale`, `pl.Position`, `pl.Order` and `pl.Align` are `str` enums
   of the same values.
@@ -194,13 +215,18 @@ width.
 | Setting | Default | Meaning |
 |---|---|---|
 | `text` | — | Title text: a string or rich content; `\n` starts a line. |
-| `font_size` | '1.4rem' | Font size; default 1.4 × the base font size. Length; `%`: of the parent's font size. |
-| `font_weight` | 'bold' | `bold` or `normal`. |
+| `font_size` | '1em' | Font size; default the base font size. Length; `%`: of the parent's font size. |
+| `font_weight` | 'bold' | `bold`, `normal` or a weight 1–1000. |
+| `font_style` | 'normal' | `normal`, `italic`, `oblique` or `"oblique 10deg"`. |
 | `align` | 'center' | Alignment. |
 | `over` | 'axes' | Width it is aligned and wrapped within: from the leftmost to the rightmost axes, or the whole figure. |
 | `pad` | '0.5em' | Gap between the title and the plots; default half the font size. Length. |
 | `color` | 'var(text_color)' | Text color. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `rule_gap` | '0.5em' | Gap between the title and the figure's `title_rule`. Length; `%`: of the font size. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Shared axes
@@ -277,7 +303,10 @@ with outer labels only.
 | `vars` | — | Custom variables, read by `var(--name)` in any setting here and below: `{"accent": "#c00"}`. |
 | `scaling` | 1.0 | Multiplies every font size, line width, marker size, tick length and pad of the style; default 1. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 | `text_color` | inherited ('black') | Text color. |
 | `line_width` | inherited (1.25) | Default line width. Length. |
 | `palette` | inherited (10 colors) | Colors of series without one. |
@@ -285,7 +314,7 @@ with outer labels only.
 | `rasterize` | inherited (False) | `True` or a dpi: series drawn as images inside the PDF. |
 | `simplify` | inherited ('auto') | pdf_io's `simplify` for every series; default `"auto"`. |
 | `data` | inherited (None) | A table whose columns the series' data arguments name. |
-| `color_map` | inherited ('viridis') | Default color map (alias `cmap`): of heatmaps, contours and numbers given as colors. |
+| `color_map` | inherited ('rainbow_llhh') | Default color map (alias `cmap`): of heatmaps, contours and numbers given as colors. |
 | `decimal_separator` | inherited ('.') | Decimal separator of numbers (`"."`). |
 | `thousands_separator` | inherited ('') | Thousands separator (`""`: none). |
 | `minus` | inherited ('hyphen') | `hyphen` (`-`) or `minus` (U+2212, from an installed font). |
@@ -323,14 +352,17 @@ axes clip.
 | `vars` | — | Custom variables, read by `var(--name)` in any setting here and below: `{"accent": "#c00"}`. |
 | `share` | — | Another plot whose x and y axes this plot shares. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 | `text_color` | inherited ('black') | Text color. |
 | `line_width` | inherited (1.25) | Default line width. Length. |
 | `palette` | inherited (10 colors) | Colors of series without one. |
 | `alpha` | inherited (1.0) | Default opacity of series. |
 | `rasterize` | inherited (False) | `True` or a dpi: series drawn as images inside the PDF. |
 | `simplify` | inherited ('auto') | pdf_io's `simplify` for every series: `"auto"`, `True`, a dpi or `False`. |
-| `color_map` | inherited ('viridis') | Default color map (alias `cmap`): of heatmaps, contours and numbers given as colors. |
+| `color_map` | inherited ('rainbow_llhh') | Default color map (alias `cmap`): of heatmaps, contours and numbers given as colors. |
 | `data` | inherited (None) | A table (dict, pandas or polars data frame, numpy structured array): strings in the data arguments of series name its columns. |
 | `decimal_separator` | inherited ('.') | Decimal separator of numbers (`"."`). |
 | `thousands_separator` | inherited ('') | Thousands separator (`""`: none). |
@@ -346,13 +378,17 @@ axes clip.
 | Setting | Default | Meaning |
 |---|---|---|
 | `text` | — | Title text: a string or rich content. |
-| `font_size` | '1.2em' | Font size; default 1.2 × the base font size. Length; `%`: of the parent's font size. |
-| `font_weight` | 'normal' | `normal` or `bold`. |
+| `font_size` | '1em' | Font size; default the base font size. Length; `%`: of the parent's font size. |
+| `font_weight` | 'normal' | `normal`, `bold` or a weight 1–1000. |
+| `font_style` | 'normal' | `normal`, `italic`, `oblique` or `"oblique 10deg"`. |
 | `color` | 'var(text_color)' | Text color. |
 | `align` | 'center' | Alignment over the axes. |
 | `pad` | 5.0 | Gap above the axes. Length; `%`: of the axes height. |
 | `over` | 'axes' | Width the title is aligned within: the axes, or the axes and the y axis labels. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Legend
@@ -403,8 +439,12 @@ candidate covers more than 2 % marked cells; else the candidate covering the few
 | `row_height` | '1.35em' | Height of an entry. Length; `%`: of the font size. |
 | `glyph_gap` | '0.5em' | Gap between a symbol and its text. Length; `%`: of the font size. |
 | `column_gap` | '1em' | Gap between columns. Length; `%`: of the font size. |
+| `title_gap` | '0.3em' | Gap below the title. Length; `%`: of the font size. |
 | `inner_pad` | 'auto' | Space inside the box; `"auto"`: 0.5em with a frame, 0.15em without. Length; `%`: of the font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Decorations
@@ -488,8 +528,12 @@ Text:
 | `coords` | 'data' | `data`, `axes` (0–1) or `figure` (0–1). |
 | `color` | 'var(text_color)' | Text color; default `text_color`. |
 | `font_size` | inherited (11.0) | Font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
-| `font_weight` | 'normal' | `normal` or `bold`. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
+| `font_weight` | 'normal' | `normal`, `bold` or a weight 1–1000. |
+| `font_style` | 'normal' | `normal`, `italic`, `oblique` or `"oblique 10deg"`. |
 | `text_color` | inherited ('black') | Text color. |
 | `name` | — | Legend entry; unset: not in the legend. |
 | `alpha` | 1.0 | Opacity. |
@@ -507,8 +551,12 @@ Annotate:
 | `coords` | 'data' | `data`, `axes` (0–1) or `figure` (0–1). |
 | `color` | 'var(text_color)' | Text color; default `text_color`. |
 | `font_size` | inherited (11.0) | Font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
-| `font_weight` | 'normal' | `normal` or `bold`. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
+| `font_weight` | 'normal' | `normal`, `bold` or a weight 1–1000. |
+| `font_style` | 'normal' | `normal`, `italic`, `oblique` or `"oblique 10deg"`. |
 | `text_color` | inherited ('black') | Text color. |
 | `name` | — | Legend entry; unset: not in the legend. |
 | `alpha` | 1.0 | Opacity. |
@@ -642,8 +690,10 @@ or the plot's `spines` is set.
 | `tick_format` | 'auto' | Number format: `auto`, `percent`, `sci`, `eng`, `si`, `int`, a format string or a function. |
 | `tick_rotation` | 'auto' | Label rotation in degrees, or `"auto"` (45° when category labels overlap). Angle (bare: degrees). |
 | `max_ticks` | 'auto' | Most major ticks; `"auto"`: one per `tick_spacing` of axis length, at least 2, at most `auto_max_ticks`. |
-| `tick_spacing` | ('calc(3.5 * var(tick_font_size))', 'calc(2.5 * var(tick_font_size))') | Space per automatic tick, in tick label font sizes, on horizontal and vertical axes. Length; `%`: of the font size. |
-| `time_tick_spacing` | ('calc(5 * var(tick_font_size))', 'calc(2.5 * var(tick_font_size))') | `tick_spacing` of time axes. Length; `%`: of the font size. |
+| `tick_spacing` | ('3em', '2em') | Space per automatic tick, in tick label font sizes, on horizontal and vertical axes. Length; `em` and `%`: of `tick_font_size`. |
+| `time_tick_spacing` | ('5em', '2.5em') | `tick_spacing` of time axes. Length; `em` and `%`: of `tick_font_size`. |
+| `tick_label_gap` | '0.6em' | Smallest gap between neighbouring tick labels side by side: fewer numeric ticks, or category labels rotated and thinned out, below it. Length; `em` and `%`: of `tick_font_size`. |
+| `category_label_spacing` | ('1.6em', '1.3em') | Distance between category labels: rotated (horizontal axes) and stacked (vertical axes); labels closer than it are thinned out. Length; `em` and `%`: of `tick_font_size`. |
 | `auto_max_ticks` | (10, 8) | Most automatic ticks on numeric and time axes. |
 | `sci_limits` | (-4, 5) | Exponents beyond which labels become mantissas × 10ᵏ. |
 | `tick_length` | 6.0 | Tick length. Length; `%`: of the axes side across the axis. |
@@ -658,10 +708,10 @@ or the plot's `spines` is set.
 | `tick_color` | 'var(color)' | Tick color. |
 | `tick_label_color` | 'var(color)' | Tick label color. |
 | `label_color` | 'var(color)' | Axis title color. |
-| `label_weight` | 'normal' | Axis title weight. |
-| `label_style` | 'normal' | Axis title style. |
+| `label_weight` | 'normal' | Axis title weight: `normal`, `bold` or 1–1000. |
+| `label_style` | 'normal' | Axis title style: `normal`, `italic`, `oblique` or `"oblique 10deg"`. |
 | `side` | x: 'bottom' / y: 'left' | Where the ticks, labels and axis line go: `bottom` or `top` (x axis), `left` or `right` (y axis). |
-| `tick_label_weight` | 'normal' | Tick label weight. |
+| `tick_label_weight` | 'normal' | Tick label weight: `normal`, `bold` or 1–1000. |
 | `mirror` | False | Ticks also on the opposite side of the axes. |
 | `spine_offset` | 0.0 | Distance the axis line (with its ticks and labels) is moved away from the axes. Length; `%`: of the axes side across the axis. |
 | `spine_trim` | False | Axis line from the first to the last major tick only. |
@@ -681,7 +731,10 @@ or the plot's `spines` is set.
 | `minor_grid_style` | 'var(grid_style)' | Minor grid style; default `grid_style`. Length. |
 | `visible` | True | Draw the axis (ticks, labels). |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 | `text_color` | inherited ('black') | Text color. |
 | `decimal_separator` | inherited ('.') | Decimal separator of numbers (`"."`). |
 | `thousands_separator` | inherited ('') | Thousands separator (`""`: none). |
@@ -778,7 +831,7 @@ the style's map); numbers in `size` are diameters, or values mapped through `siz
 | `edge_width` | 0.5 | Outline width. Length. |
 | `filled` | True | `True`: filled with the color; `False`: hollow, outlined in the color; a number: filled at that opacity and outlined in the color. |
 | `size_basis` | 'area' | `area`: shapes of the same size have the same area; `box`: size is the width of the shape's box. |
-| `color_map` | inherited ('viridis') | How numbers in `color` become colors: a `ColorMap`, a map name or colors (alias `cmap`); default: the style's. |
+| `color_map` | inherited ('rainbow_llhh') | How numbers in `color` become colors: a `ColorMap`, a map name or colors (alias `cmap`); default: the style's. |
 | `size_map` | — | How numbers in `size` become sizes: a `SizeMap` (alias `smap`); without it, numbers are sizes in px. |
 | `size_legend` | True | With a `size_map`: a size key in the legend (`True`), none (`False`), or the values to show (a list). |
 | `order` | — | Drawing order: `"density"` (densest drawn last), `"-density"`, or sort keys per point (ascending); default: call order. |
@@ -791,8 +844,11 @@ the style's map); numbers in `size` are diameters, or values mapped through `siz
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Line
@@ -839,8 +895,11 @@ Named line styles scale with the width. Markers (`marker`, `marker_size`,
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Fill
@@ -868,8 +927,11 @@ x, y1 or y2 is), so a band with the settings of its line matches it. With
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Box
@@ -890,7 +952,7 @@ category.
 | Setting | Default | Meaning |
 |---|---|---|
 | `color` | — | Box fill: a color, one per box (list or dict by category), or numbers per box (list or dict) mapped through `color_map`; default: the next palette color. |
-| `color_map` | inherited ('viridis') | How numbers in `color` become colors: a `ColorMap`, a map name or colors (alias `cmap`); default: the style's. |
+| `color_map` | inherited ('rainbow_llhh') | How numbers in `color` become colors: a `ColorMap`, a map name or colors (alias `cmap`); default: the style's. |
 | `edge_color` | 'black' | Box outline, whiskers, caps and median: a color, `"series"` (each box's own color) or `"auto"` (a grey 0.6 × as light as the series' lightest color, as seaborn). |
 | `whisker_color` | — | Whisker and cap color; default `edge_color`. |
 | `whisker_style` | 'solid' | Whisker line style: `solid`, `dashed`, `dotted`, `dashdot` or a dash list (caps stay solid). Length. |
@@ -923,8 +985,11 @@ category.
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Heatmap
@@ -945,7 +1010,7 @@ all cells), in black or white, whichever contrasts more (at most 2,500 cells unl
 <!-- settings:Heatmap -->
 | Setting | Default | Meaning |
 |---|---|---|
-| `color_map` | inherited ('viridis') | A `ColorMap`, a map name or a list of colors. |
+| `color_map` | inherited ('rainbow_llhh') | A `ColorMap`, a map name or a list of colors. |
 | `color_limits` | — | Override of the map's limits for this series. |
 | `color_scale` | — | Override of the map's scale. |
 | `mode` | 'image' | `image` (one image pixel per cell), `cells` (rectangles) or `smooth` (interpolated). |
@@ -961,8 +1026,11 @@ all cells), in black or white, whichever contrasts more (at most 2,500 cells unl
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 | `decimal_separator` | inherited ('.') | Decimal separator of numbers (`"."`). |
 | `thousands_separator` | inherited ('') | Thousands separator (`""`: none). |
 | `minus` | inherited ('hyphen') | `hyphen` (`-`) or `minus` (U+2212, from an installed font). |
@@ -983,7 +1051,7 @@ pl.Bar(x, height=None, plot=None, **settings)
 | Setting | Default | Meaning |
 |---|---|---|
 | `color` | — | Bar fill: a color, one per bar (list or dict by category), or numbers per bar (list or dict) mapped through `color_map`; default: the next palette color. |
-| `color_map` | inherited ('viridis') | How numbers in `color` become colors: a `ColorMap`, a map name or colors (alias `cmap`); default: the style's. |
+| `color_map` | inherited ('rainbow_llhh') | How numbers in `color` become colors: a `ColorMap`, a map name or colors (alias `cmap`); default: the style's. |
 | `edge_color` | — | Outline color; default none. |
 | `edge_width` | 0.0 | Outline width. Length. |
 | `width` | 0.8 | Bar width: a category's slot (category units) or data units (a `timedelta` on time axes). Length; bare numbers: data units. |
@@ -1004,8 +1072,11 @@ pl.Bar(x, height=None, plot=None, **settings)
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 | `decimal_separator` | inherited ('.') | Decimal separator of numbers (`"."`). |
 | `thousands_separator` | inherited ('') | Thousands separator (`""`: none). |
 | `minus` | inherited ('hyphen') | `hyphen` (`-`) or `minus` (U+2212, from an installed font). |
@@ -1049,8 +1120,11 @@ pl.Hist(values, plot=None, **settings)
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 | `decimal_separator` | inherited ('.') | Decimal separator of numbers (`"."`). |
 | `thousands_separator` | inherited ('') | Thousands separator (`""`: none). |
 | `minus` | inherited ('hyphen') | `hyphen` (`-`) or `minus` (U+2212, from an installed font). |
@@ -1089,8 +1163,11 @@ A Gaussian kernel density of each set on a common grid of `grid` points, extendi
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Kde2d
@@ -1114,7 +1191,7 @@ labels, colorbar).
 |---|---|---|
 | `filled` | False | Fill the bands between levels. |
 | `lines` | True | Draw the iso-lines. |
-| `color_map` | inherited ('viridis') | Color map of the levels. |
+| `color_map` | inherited ('rainbow_llhh') | Color map of the levels. |
 | `colors` | — | Line color, or one per level, instead of the map. |
 | `line_width` | 'calc(0.6 * var(line_width))' | Line width; default 0.6 × the plot's. Length. |
 | `line_style` | 'solid' | Line style. Length. |
@@ -1128,8 +1205,11 @@ labels, colorbar).
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 | `decimal_separator` | inherited ('.') | Decimal separator of numbers (`"."`). |
 | `thousands_separator` | inherited ('') | Thousands separator (`""`: none). |
 | `minus` | inherited ('hyphen') | `hyphen` (`-`) or `minus` (U+2212, from an installed font). |
@@ -1170,8 +1250,11 @@ A step line through the sorted values of each set: `stat` `proportion`, `count`
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Violin
@@ -1186,7 +1269,7 @@ pl.Violin(values, positions=None, plot=None, **settings)
 | Setting | Default | Meaning |
 |---|---|---|
 | `color` | — | Fill: a color, one per violin (list or dict by category), or numbers per violin mapped through `color_map`; default the next palette color. |
-| `color_map` | inherited ('viridis') | How numbers in `color` become colors: a `ColorMap`, a map name or colors (alias `cmap`); default: the style's. |
+| `color_map` | inherited ('rainbow_llhh') | How numbers in `color` become colors: a `ColorMap`, a map name or colors (alias `cmap`); default: the style's. |
 | `edge_color` | '#333333' | Outline and inner color. |
 | `edge_width` | 0.75 | Outline width. Length. |
 | `saturation` | 1.0 | Saturation of the fills. |
@@ -1208,8 +1291,11 @@ pl.Violin(values, positions=None, plot=None, **settings)
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Strip and swarm
@@ -1231,7 +1317,7 @@ Points of each category's values: `Strip` spreads them by uniform jitter (± `ji
 | `edge_width` | 0.5 | Outline width. Length. |
 | `filled` | True | `True`: filled with the color; `False`: hollow, outlined in the color; a number: filled at that opacity and outlined in the color. |
 | `size_basis` | 'area' | `area`: shapes of the same size have the same area; `box`: size is the width of the shape's box. |
-| `color_map` | inherited ('viridis') | How numbers in `color` become colors: a `ColorMap`, a map name or colors (alias `cmap`); default: the style's. |
+| `color_map` | inherited ('rainbow_llhh') | How numbers in `color` become colors: a `ColorMap`, a map name or colors (alias `cmap`); default: the style's. |
 | `size_map` | — | How numbers in `size` become sizes: a `SizeMap` (alias `smap`); without it, numbers are sizes in px. |
 | `size_legend` | True | With a `size_map`: a size key in the legend (`True`), none (`False`), or the values to show (a list). |
 | `orientation` | 'vertical' | `vertical` (categories on x) or `horizontal`. |
@@ -1249,8 +1335,11 @@ Points of each category's values: `Strip` spreads them by uniform jitter (± `ji
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Area
@@ -1277,8 +1366,11 @@ Layers (rows of `ys`, or a dict `{name: values}`, one legend entry each) stacked
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Errorbar
@@ -1312,8 +1404,11 @@ Error bars on their own (markers only with `marker=`); `y_error_style="band"` fi
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Stem
@@ -1346,8 +1441,11 @@ Stems from `baseline` to each value with a marker (lollipops), and a baseline li
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Regression
@@ -1386,8 +1484,11 @@ A least-squares polynomial of `order` with the confidence band of the mean (Stud
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Hist2d
@@ -1401,7 +1502,7 @@ Counts in rectangular bins (even on the axis scales), drawn as a heatmap with th
 <!-- settings:Hist2d -->
 | Setting | Default | Meaning |
 |---|---|---|
-| `color_map` | inherited ('viridis') | A `ColorMap`, a map name or a list of colors. |
+| `color_map` | inherited ('rainbow_llhh') | A `ColorMap`, a map name or a list of colors. |
 | `color_limits` | — | Override of the map's limits for this series. |
 | `color_scale` | — | Override of the map's scale. |
 | `mode` | 'image' | `image` (one image pixel per cell), `cells` (rectangles) or `smooth` (interpolated). |
@@ -1416,8 +1517,11 @@ Counts in rectangular bins (even on the axis scales), drawn as a heatmap with th
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 | `decimal_separator` | inherited ('.') | Decimal separator of numbers (`"."`). |
 | `thousands_separator` | inherited ('') | Thousands separator (`""`: none). |
 | `minus` | inherited ('hyphen') | `hyphen` (`-`) or `minus` (U+2212, from an installed font). |
@@ -1450,7 +1554,7 @@ aspect (and the counts depend on it). Points outside the axes are not counted. C
 | `weights` | — | A weight per point (sums). |
 | `stat` | 'count' | `count`, `probability` or `percent`. |
 | `min_count` | 1.0 | Hexagons below this count are not drawn. |
-| `color_map` | inherited ('viridis') | A `ColorMap`, a map name or colors. |
+| `color_map` | inherited ('rainbow_llhh') | A `ColorMap`, a map name or colors. |
 | `color_limits` | — | Override of the map's limits. |
 | `color_scale` | — | Override of the map's scale. |
 | `edge_color` | — | Hexagon outline color; default none. |
@@ -1462,8 +1566,11 @@ aspect (and the counts depend on it). Points outside the axes are not counted. C
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 <!-- /settings -->
 
 ### Contour
@@ -1480,7 +1587,7 @@ Iso-lines (`lines`) and filled bands (`filled`) of a grid at nodes `x`/`y`. `lev
 | `levels` | 10 | A number of levels (nice values over the data) or the level values. |
 | `filled` | False | Fill the bands between levels. |
 | `lines` | True | Draw the iso-lines. |
-| `color_map` | inherited ('viridis') | Color map of the levels. |
+| `color_map` | inherited ('rainbow_llhh') | Color map of the levels. |
 | `colors` | — | Line color, or one per level, instead of the map. |
 | `line_width` | 'calc(0.6 * var(line_width))' | Line width; default 0.6 × the plot's. Length. |
 | `line_style` | 'solid' | Line style. Length. |
@@ -1495,8 +1602,11 @@ Iso-lines (`lines`) and filled bands (`filled`) of a grid at nodes `x`/`y`. `lev
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 | `decimal_separator` | inherited ('.') | Decimal separator of numbers (`"."`). |
 | `thousands_separator` | inherited ('') | Thousands separator (`""`: none). |
 | `minus` | inherited ('hyphen') | `hyphen` (`-`) or `minus` (U+2212, from an installed font). |
@@ -1525,6 +1635,7 @@ Wedges of `values` (a sequence or a dict `{label: value}`) from `start`, on a pl
 | `sort` | False | Sort the wedges by decreasing value. |
 | `label_position` | 'outside' | Where the names go: `outside`, `inside` or `none` (in the legend instead). |
 | `value_labels` | False | Write each wedge's `percent` or `value` inside it (outside, with a leader line, when it does not fit). |
+| `label_spacing` | '1.25em' | Smallest distance between outside labels on a side. Length; `%`: of the font size. |
 | `label_format` | 'auto' | Number format of the value labels (percentages: of 100). |
 | `edge_color` | 'white' | Wedge outline color; `none`: no outline. |
 | `edge_width` | 1.25 | Wedge outline width. Length. |
@@ -1534,8 +1645,11 @@ Wedges of `values` (a sequence or a dict `{label: value}`) from `start`, on a pl
 | `rasterize` | inherited (False) | `True` or a dpi: drawn as an image inside the PDF. |
 | `simplify` | inherited ('auto') | `"auto"`, `True`, a dpi or `False`: pdf_io's `simplify`. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
 | `text_color` | inherited ('black') | Text color. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 | `decimal_separator` | inherited ('.') | Decimal separator of numbers (`"."`). |
 | `thousands_separator` | inherited ('') | Thousands separator (`""`: none). |
 | `minus` | inherited ('hyphen') | `hyphen` (`-`) or `minus` (U+2212, from an installed font). |
@@ -1572,7 +1686,10 @@ side, so axes stay aligned. A bar in its own area runs along the neighbouring ax
 | `frame_color` | '#666666' | Outline color. |
 | `frame_width` | 0.5 | Outline width. Length. |
 | `font_size` | inherited (11.0) | Base font size. Length; `%`: of the parent's font size. |
-| `font_family` | inherited ('SF Pro Text, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_family` | inherited ('SF Pro, Inter, Helvetica, Arial, sans-serif') | Font family. |
+| `font_stretch` | inherited ('normal') | Font width: `normal`, `condensed`, …, or a percentage (`"87.5%"`); the `wdth` axis of variable fonts. |
+| `font_variations` | inherited (None) | Variable font axes: `{"GRAD": 50}` or `'"GRAD" 50, "wght" 650'`. |
+| `font_optical_sizing` | inherited ('auto') | `auto`: a variable font's `opsz` axis follows the font size; `none`. |
 | `text_color` | inherited ('black') | Text color. |
 | `decimal_separator` | inherited ('.') | Decimal separator of numbers (`"."`). |
 | `thousands_separator` | inherited ('') | Thousands separator (`""`: none). |
@@ -1592,14 +1709,25 @@ default palette `pl.PALETTE` (`"okabe_ito"`) is Okabe–Ito's eight colorblind-s
 plus indigo and dark brown, chosen as the pair farthest from every other color (in Oklab)
 under normal and simulated protan, deutan and tritan vision.
 
-`palette` takes a list of colors, a registered name, or a function `n -> colors`, called
-with the number of series of the plot that take a palette color.
+`palette` takes a `pl.Palette`, a registered name (`"tab10"`; `"tab10_r"` reversed), a
+list of colors (or one comma-separated string: `"red, teal 0.7"`), or a function `n -> colors`, called with the number of series of the plot
+that take a palette color.
 
 ```python
-pl.register_palette(name, colors_or_function)
+pl.Palette(colors="okabe_ito", name=None)    # a name, colors, a Palette or n -> colors
+pl.register_palette(name, palette)           # a Palette, colors or a function
 pl.palette_names()
 ```
 
+| `Palette` | |
+|---|---|
+| `colors(n=None)` | the colors: all, or `n` (a list repeats, as series reuse it; a function is called with `n`) |
+| `len(p)`, `p[i]`, `p[a:b]`, `iter(p)` | lists only: count; a color (indices wrap); a sub-palette |
+| `reversed()`, `lighter(k=0.25)`, `darker(k=0.25)` | copies: reversed; each color moved by `k` toward white or black in Oklab |
+
+`ColorMap.to_palette(n)` samples a gradient into `n` colors, at the centers of `n` equal
+parts: `palette=pl.ColorMap("viridis").to_palette(5)` for ordered categories.
+
 | Palette | Colors |
 |---|---|
 | `okabe_ito` | plot_io's default (10) |
@@ -1616,33 +1744,55 @@ pl.palette_names()
 | `economist` | The Economist (ggthemes, pre-2017) (10) |
 | `fivethirtyeight` | matplotlib's fivethirtyeight style (6) |
 | `greys` | black to light grey (4) |
+| `set1`, `set2`, `set3`, `paired`, `accent`, `dark2`, `pastel1`, `pastel2` | ColorBrewer's qualitative schemes by Brewer (Apache-2.0) (8–12) |
+| `batlow`, `batlowk`, `batloww`, `devon`, `lajolla`, `bamako`, `davos`, `bilbao`, `nuuk`, `oslo`, `grayc`, `hawaii`, `lapaz`, `tokyo`, `buda`, `acton`, `turku`, `imola`, `glasgow`, `lipari`, `navia` | Crameri's categorical Scientific colour maps 8 (MIT): the first colors differ most (100) |
 
 ### Color maps
 
 ```python
-pl.ColorMap(colors="viridis", positions=None, limits="auto", scale="linear",
-            under=None, over=None, bad=None, space=None, name=None)
+pl.ColorMap(colors="rainbow_llhh", positions=None, limits="auto", scale="linear",
+            under=None, over=None, bad=None, space=None, name=None, interpolation=None,
+            widen_colors=1, widen_sides=1.0)
 pl.register_color_map(name, color_map)
 pl.color_map_names()
 ```
 
 | Member | |
 |---|---|
-| `colors` | a name (`viridis`, `magma`, `inferno`, `plasma`, `cividis`, `coolwarm`, `grey`, `rocket`, `mako`, `flare`, `crest`, `vlag`, `icefire`, `jet`, `parula`, `turbo`, `ylgnbu`, `blues`, `ggplot2`; `_r` reverses), a list of colors (evenly spaced or at `positions`), a `ColorMap` (copied) or a function `t -> color` |
+| `colors` | a name (`viridis`, `magma`, `inferno`, `plasma`, `cividis`, `coolwarm`, `grey`, `rocket`, `mako`, `flare`, `crest`, `vlag`, `icefire`, `jet`, `parula`, `turbo`, `ggplot2`, the rainbows, ColorBrewer's and Crameri's maps below, in any case (`"RdBu"`, `"batlowK"`); `_r` reverses), a list of colors (evenly spaced or at `positions`; or one string, comma-separated: `"violet 0.4, sky 0.4, green 0.4"`), a `ColorMap` (copied) or a function `t -> color` |
 | `limits`, `scale` | axis syntax, applied to the mapped values; `"auto"` covers every series using the map |
 | `under`, `over`, `bad` | colors below/above the limits (default: the end colors) and of missing values (default: transparent) |
-| `space` | `"oklab"` (default for color lists: perceptually even) or `"srgb"` (bundled maps, whose stops are already a dense perceptual sampling) |
+| `space` | interpolation between the colors: `"oklab"` (default, for every map: perceptually even) or `"srgb"` |
+| `interpolation` | `"linear"` (default): between neighboring colors; `"nearest"`: equal steps, one per color (`n` colors, `n` bins; with `positions`, each step starts at its position); `"smooth"`: a Bézier curve with the colors as control points, through the first and last only (no `positions`); `"spline"`: a monotone cubic curve through every color (PCHIP in Oklab: no overshoot between colors) |
+| `widen_colors`, `widen_sides` | each inner color of a list repeated `widen_colors` times, each end color `round(widen_sides × widen_colors)` times: wider bands around the colors |
 | `cm(t)`, `colors_at(ts)` | color at t ∈ [0, 1]; bulk colors (C) |
 | `reversed()`, `resampled(n)`, `truncated(lo, hi)`, `with_extremes(…)` | copies: reversed; n flat steps; a part stretched to [0, 1]; new extremes |
-| `to_pdf_io()` | the equivalent pdf_io color map (Oklab maps as 256 sRGB stops) |
+| `to_palette(n)` | a `Palette` of `n` colors sampled at the centers of `n` equal parts |
+| `to_pdf_io()` | the equivalent pdf_io color map (maps with fewer than 256 colors as 256 sRGB stops) |
 
 Bundled data: viridis, magma, inferno and plasma by van der Walt and Smith (CC0); cividis
 by Nuñez, Anderton and Renslow; coolwarm by Moreland; rocket, mako, flare, crest, vlag and
 icefire from seaborn by Waskom (BSD-3-Clause); jet from matplotlib; a parula-like map;
-turbo by Mikhailov (Google, Apache-2.0); YlGnBu and Blues from ColorBrewer by Brewer
-(Apache-2.0);
-`ggplot2` is ggplot2's continuous default (`#132B43` → `#56B1F7`, Oklab). The
-`color_map` setting (alias `cmap`; inherited, default `"viridis"`) is the map of heatmaps,
+turbo by Mikhailov (Google, Apache-2.0);
+the rainbows, built from named colors with `widen_colors=6, widen_sides=0.6` and
+`interpolation="smooth"` (violet, sky,
+green, yellow, orange, rose): `rainbow` (all at level 0.4), `rainbow_neutral` (0.5),
+`rainbow_l0hh` (from white, then levels 0.1 to 0.6), `rainbow_llhh` (0.16 to 0.6),
+`rainbow_llh` (0.16 to 0.4), `rainbow_hlh` (dark ends, light middle); diverging maps from
+named colors: `blue_white_red` (sky, white, rose), `blue_white_red_hc` (levels 0.6 at the
+ends), `blue_gray_red` (a gray 0.2 middle), `blue_gray_red_hc`;
+ColorBrewer's schemes by Brewer (Apache-2.0): sequential `blues`, `bugn`, `bupu`, `gnbu`,
+`greens`, `greys`, `oranges`, `orrd`, `pubu`, `pubugn`, `purd`, `purples`, `rdpu`, `reds`,
+`ylgn`, `ylgnbu`, `ylorbr`, `ylorrd` (9 colors) and diverging `brbg`, `piyg`, `prgn`, `puor`,
+`rdbu`, `rdgy`, `rdylbu`, `rdylgn`, `spectral` (11 colors); Crameri's Scientific colour maps
+8 (MIT; Crameri, Shephard and Heron 2020): sequential `batlow`, `batlowk`, `batloww`,
+`devon`, `lajolla`, `bamako`, `davos`, `bilbao`, `nuuk`, `oslo`, `grayc`, `hawaii`, `lapaz`,
+`tokyo`, `buda`, `acton`, `turku`, `imola`, `glasgow`, `lipari`, `navia`, diverging `broc`,
+`cork`, `vik`, `lisbon`, `tofino`, `berlin`, `roma`, `bam`, `vanimo`, `managua`,
+multi-sequential `oleron`, `bukavu`, `fes` and cyclic `romao`, `bamo`, `broco`, `corko`,
+`viko` (256 colors each);
+`ggplot2` is ggplot2's continuous default (`#132B43` → `#56B1F7`). The
+`color_map` setting (alias `cmap`; inherited, default `"rainbow_llhh"`) is the map of heatmaps,
 contours and numbers given as colors. One `ColorMap` object given to several series
 shares its `"auto"` limits.
 
@@ -1891,9 +2041,9 @@ documented default properties. What cannot be expressed: legend titles naming a
 | `slots.py`, `stacking.py`, `labels.py`, `shapes.py` | category slots, stacking, value labels, bulk rectangles and polygons |
 | `stats.py` | bins, densities, contours, LOWESS and swarm layout (pdf_io's C helpers) |
 | `decorations.py` | reference lines, spans, text and annotations |
-| `maps/` | `ColorMap`, `SizeMap`, Oklab, bundled map data |
-| `markers.py`, `style.py`, `text.py` | marker shapes, palette references and dashes, rich one-line text |
-| `palettes.py` | palette registry, bundled palettes, ggplot2's hues (CIE LCh(uv)) |
+| `color/` | colors: `values.py` (the `color` validator, named color scales, palette references, alpha, saturation, luminance), `palettes.py` (palettes: the discrete colors series take in turn; registry, ggplot2's hues), `maps.py` (`ColorMap`: gradients numbers are mapped onto; Oklab from pdf_io), `data.py` (bundled map and palette colors) |
+| `sizemaps.py` | `SizeMap`: values to marker diameters |
+| `markers.py`, `lines.py`, `text.py` | marker shapes, line dash styles, rich one-line text |
 | `styles/` | style registry and expansion; bundled styles (point libraries in `pt`) |
 | `values.py`, `density.py` | values given to `color`/`size` and their rules; `Density` (point density) |
 | `tables.py`, `facets.py` | columns of tables, `group=` splitting (`SeriesGroup`); `facet` |