docs: document defaults

gka · gka · commit 95b73e0d93e1 · 2025-05-23T00:36:09.000+02:00
diff --git a/src/lib/types.ts b/src/lib/types.ts
@@ -438,6 +438,10 @@ export type PlotDefaults = {
      */
     numberFormat: Intl.NumberFormatOptions;
     markerDotRadius: number;
+    /**
+     * fallback color to be used for null/NA
+     */
+    unknown: string;
     css: (d: string) => string | undefined;
 };
 
diff --git a/src/routes/features/defaults/+page.md b/src/routes/features/defaults/+page.md
@@ -29,6 +29,7 @@ If you're using SveltePlot in a SvelteKit project, you can even set the defaults
 | _inset_                  | Plot inset                                                                                                                                                             | px      | `0`              |
 | _colorScheme_            | Default scheme for color scale                                                                                                                                         | string  | `'turbo'`        |
 | _categoricalColorScheme_ | Default scheme for [categorical color scales](/features/color-scales#Categorical-colors)                                                                               | string  | `'observable10'` |
+| _unknown_                | Fallback color to be used when mapping NAs to colors s                                                                                                                 | string  | `'#cccccc'`      |
 | _tickSize_               | Axis tick line length                                                                                                                                                  | px      | `6`              |
 | _tickPadding_            | Distance between tick line and label                                                                                                                                   | px      | `3`              |
 | _tickFontSize_           | Tick label font size                                                                                                                                                   | px      | `11`             |
@@ -39,6 +40,7 @@ If you're using SveltePlot in a SvelteKit project, you can even set the defaults
 | _graticuleStep_          | Default step size in graticules                                                                                                                                        | degrees | `10`             |
 | _locale_                 | Default locale used in axis ticks etc.                                                                                                                                 | string  | `'en-US'`        |
 | _numberFormat_           | Default [number format options](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#options) in axis ticks | object  |                  |
+| _css_                    | For passing an `@emotion/css` instance to your plots                                                                                                                   |         |                  |
 
 <style>
     * :global(td) {
