@defra/interactive-map 0.0.17-alpha → 0.0.18-alpha

package/docs/api/symbol-registry.md

@@ -0,0 +1,115 @@
+# Symbol Registry
+
+The symbol registry is a service that manages reusable named symbols for map markers. It is available to plugin authors via `services.symbolRegistry`.
+
+> **Application code** that needs a one-off custom marker should pass [`symbolSvgContent`](./symbol-config.md#symbolsvgcontent) directly to `addMarker()` via `MarkerOptions` instead — no registration required.
+
+## Built-in symbols
+
+Two symbols are registered by default:
+
+| ID | Anchor | Description |
+|----|--------|-------------|
+| `'pin'` | `[0.5, 1]` | Teardrop pin — tip aligns with the coordinate |
+| `'circle'` | `[0.5, 0.5]` | Filled circle — centre aligns with the coordinate |
+
+Both use the standard `{{token}}` placeholders and respect the resolution order described in [Symbol Config](./symbol-config.md#how-values-are-resolved).
+
+## Methods
+
+Available on `services.symbolRegistry` inside a plugin.
+
+---
+
+### `setDefaults(defaults)`
+
+Set constructor-level defaults. Called automatically during app initialisation with the `symbolDefaults` constructor config. Plugin authors do not normally need to call this.
+
+---
+
+### `getDefaults()`
+
+Returns the merged app-wide defaults (hardcoded `symbolDefaults.js` + constructor overrides).
+
+```js
+const defaults = services.symbolRegistry.getDefaults()
+// { symbol: 'pin', backgroundColor: '#ca3535', selectedColor: { outdoor: '#0b0c0c', dark: '#ffffff' }, ... }
+```
+
+---
+
+### `register(symbolDef)`
+
+Register a custom symbol. Once registered it can be referenced by ID via `MarkerOptions.symbol` or a dataset `style.symbol`.
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `id` | `string` | Yes | Unique symbol identifier |
+| `svg` | `string` | Yes | Inner SVG path content with `{{token}}` placeholders — see [SVG structure](./symbol-config.md#svg-structure) |
+| `viewBox` | `string` | Yes | SVG viewBox, e.g. `'0 0 38 38'` |
+| `anchor` | `[number, number]` | Yes | Normalised [x, y] anchor point |
+| *(token)* | `string \| Record<string, string>` | No | Default token value for this symbol, e.g. `backgroundColor: '#1d70b8'`. `selectedColor` and `selectedWidth` are ignored here — set them via constructor `symbolDefaults`. |
+
+```js
+services.symbolRegistry.register({
+  id: 'star',
+  viewBox: '0 0 38 38',
+  anchor: [0.5, 0.5],
+  backgroundColor: '#1d70b8',
+  svg: `
+    <path d="..." fill="none" stroke="{{selectedColor}}" stroke-width="{{selectedWidth}}"/>
+    <path d="..." fill="{{backgroundColor}}" stroke="{{haloColor}}" stroke-width="{{haloWidth}}"/>
+    <path d="..." fill="{{foregroundColor}}"/>
+  `
+})
+```
+
+See [Symbol Config](./symbol-config.md) for the full list of token properties and the SVG structure convention.
+
+---
+
+### `get(id)`
+
+Returns the symbol definition for the given ID, or `undefined` if not registered.
+
+```js
+const symbolDef = services.symbolRegistry.get('pin')
+```
+
+---
+
+### `list()`
+
+Returns an array of all registered symbol definitions.
+
+```js
+const symbols = services.symbolRegistry.list()
+```
+
+---
+
+### `resolve(symbolDef, styleColors, mapStyleId)`
+
+Resolves a symbol's SVG for **normal (unselected) rendering**. The `{{selectedColor}}` token is always replaced with an empty string — the selection ring is structurally present but invisible.
+
+```js
+const svg = services.symbolRegistry.resolve(
+  services.symbolRegistry.get('pin'),
+  { backgroundColor: '#d4351c' },
+  'outdoor'
+)
+```
+
+---
+
+### `resolveSelected(symbolDef, styleColors, mapStyleId)`
+
+Resolves a symbol's SVG for **selected rendering**. The `{{selectedColor}}` token uses the cascade value. Use this when rendering the highlight layer for an interact or datasets selection.
+
+```js
+const svg = services.symbolRegistry.resolveSelected(
+  services.symbolRegistry.get('pin'),
+  { backgroundColor: '#d4351c' },
+  'outdoor'
+)
+```

package/docs/api.md

@@ -264,18 +264,6 @@ URL query parameter key used to persist map visibility state.
 
 ---
 
-### `markerColor`
-**Type:** `string | Object<string, string>`
-**Default:** `'#ff0000'`
-
-Default colour for map markers. Can be overridden per marker when calling `addMarker()`.
-
-May be provided as:
-- A single colour value applied to all map styles
-- An object keyed by map style ID, allowing different colours per style
-
----
-
 ### `markers`
 **Type:** `MarkerConfig[]`
 
@@ -285,14 +273,29 @@ See [MarkerConfig](./api/marker-config.md) for full details.
 
 ---
 
-### `markerShape`
-**Type:** `string`
-**Default:** `'pin'`
+### `symbolDefaults`
+**Type:** `Partial<SymbolDefaults>`
 
-Default shape for map markers. Can be overridden per marker when calling `addMarker()`.
+App-wide defaults for symbol and marker appearance. These values apply across all markers and datasets unless a more specific value is set at the symbol or per-marker level. Any property omitted here falls back to the built-in default:
 
-> [!NOTE]
-> Currently only `'pin'` is available. Additional shapes are planned for a future release.
+| Property | Built-in default |
+|---|---|
+| `symbol` | `'pin'` |
+| `backgroundColor` | `'#ca3535'` |
+| `foregroundColor` | `'#ffffff'` |
+| `haloWidth` | `'1'` |
+| `selectedWidth` | `'6'` |
+
+```js
+new InteractiveMap('map', {
+  symbolDefaults: {
+    symbol: 'circle',
+    backgroundColor: { outdoor: '#1d70b8', dark: '#4c9ed9' }
+  }
+})
+```
+
+See [Symbol Config](./api/symbol-config.md) for the full property list.
 
 ---
 
@@ -488,7 +491,7 @@ Add a marker to the map.
 | `options` | [`MarkerOptions`](./api/marker-config.md#markeroptions) | Optional marker appearance options |
 
 ```js
-interactiveMap.addMarker('home', [-0.1276, 51.5074], { color: '#0000ff' })
+interactiveMap.addMarker('home', [-0.1276, 51.5074], { backgroundColor: '#1d70b8' })
 ```
 
 ---

package/docs/plugins/datasets.md

@@ -1,6 +1,6 @@
 # Datasets Plugin
 
-The datasets plugin renders GeoJSON and vector tile datasets on the map, with support for sublayer style rules, layer visibility toggling, a key panel, and runtime style and data updates.
+The datasets plugin renders GeoJSON and vector tile datasets on the map, with support for polygon, line, and symbol (point) layer types, sublayer style rules, layer visibility toggling, a key panel, and runtime style and data updates.
 
 ## Usage
 
@@ -263,6 +263,15 @@ Overrides the shape used to render the key symbol for this dataset. Defaults to
 
 Visual style for the dataset. All style properties must be nested within this object.
 
+**Common properties:**
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `opacity` | `number` | Layer opacity from `0` to `1` |
+| `symbolDescription` | `string \| Record<string, string>` | Accessible description of the symbol shown in the key |
+
+**Polygon/line properties:**
+
 | Property | Type | Description |
 |----------|------|-------------|
 | `stroke` | `string \| Record<string, string>` | Stroke (outline) colour. Accepts a plain colour string or a map-style-keyed object e.g. `{ outdoor: '#ff0000', dark: '#ffffff' }` |
@@ -273,17 +282,56 @@ Visual style for the dataset. All style properties must be nested within this ob
 | `fillPatternSvgContent` | `string` | Raw SVG content for a custom fill pattern |
 | `fillPatternForegroundColor` | `string \| Record<string, string>` | Foreground colour for the fill pattern |
 | `fillPatternBackgroundColor` | `string \| Record<string, string>` | Background colour for the fill pattern |
-| `opacity` | `number` | Layer opacity from `0` to `1` |
-| `symbolDescription` | `string \| Record<string, string>` | Accessible description of the symbol shown in the key |
 | `keySymbolShape` | `'polygon' \| 'line'` | Shape used for the key symbol |
 
+**Symbol (point) properties:**
+
+Setting `symbol` or `symbolSvgContent` renders the dataset as a point layer instead of a polygon/line layer.
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `symbol` | `string` | Registered symbol ID e.g. `'pin'`, `'circle'`, `'square'` |
+| `symbolSvgContent` | `string` | Inline SVG content for a fully custom symbol (no `<svg>` wrapper). Takes precedence over `symbol` |
+| `symbolViewBox` | `string` | SVG viewBox for the symbol e.g. `'0 0 38 38'`. Defaults to the registered symbol's viewBox |
+| `symbolAnchor` | `[number, number]` | Anchor point as a normalised `[x, y]` pair. Defaults to the registered symbol's anchor |
+| `symbolBackgroundColor` | `string \| Record<string, string>` | Background fill colour of the symbol |
+| `symbolForegroundColor` | `string \| Record<string, string>` | Foreground fill colour of the symbol (e.g. the inner dot) |
+| `symbolHaloWidth` | `string` | Stroke width of the halo in SVG units |
+| `symbolGraphic` | `string` | SVG `d` attribute for the foreground graphic path. Use named values (`'dot'`, `'cross'`, `'diamond'`, `'triangle'`, `'square'`) or supply your own path data |
+
+Symbol colour properties use the `symbol` prefix to distinguish them from polygon/line properties in the same style object. They follow the same resolution order and support style-keyed colour objects in the same way as markers — see [Symbol Config](../api/symbol-config.md) for details.
+
+`haloColor` and `selectedColor` are not settable here — they are basemap-level properties set on [`MapStyleConfig`](../api/map-style-config.md).
+
 ```js
+// Polygon/line dataset
 style: {
   stroke: { outdoor: '#d4351c', dark: '#ffffff' },
   strokeWidth: 2,
   fill: 'rgba(212,53,28,0.1)',
   symbolDescription: { outdoor: 'Red outline' }
 }
+
+// Point dataset — registered symbol with colour overrides
+style: {
+  symbol: 'pin',
+  symbolBackgroundColor: '#1d70b8',
+  symbolForegroundColor: '#ffffff'
+}
+
+// Point dataset — style-keyed colours for multi-basemap support
+style: {
+  symbol: 'pin',
+  symbolBackgroundColor: { outdoor: '#1d70b8', dark: '#5694ca' }
+}
+
+// Point dataset — custom inline SVG
+style: {
+  symbolSvgContent: '<circle cx="19" cy="19" r="12" fill="{{backgroundColor}}"/>',
+  symbolViewBox: '0 0 38 38',
+  symbolAnchor: [0.5, 0.5],
+  symbolBackgroundColor: '#1d70b8'
+}
 ```
 
 ---
@@ -292,9 +340,9 @@ style: {
 
 **Type:** `Sublayer[]`
 
-Array of sublayer rules that partition the dataset into visually distinct groups based on feature filters. Each sublayer is rendered as a separate pair of map layers.
+Array of sublayer rules that partition the dataset into visually distinct groups based on feature filters. Each sublayer is rendered as a separate map layer.
 
-Sublayers inherit the parent dataset's style and only override what they specify. Fill precedence (highest to lowest): sublayer's own `fillPattern` → sublayer's own `fill` → parent's `fillPattern` → parent's `fill`.
+Sublayers inherit the parent dataset's style and only override what they specify in their own `style` object. For polygon/line datasets, fill precedence is (highest to lowest): sublayer `fillPattern` → sublayer `fill` → parent `fillPattern` → parent `fill`. For symbol datasets, each symbol property is inherited individually from the parent unless the sublayer sets it explicitly.
 
 #### `Sublayer` properties
 
@@ -303,10 +351,12 @@ Sublayers inherit the parent dataset's style and only override what they specify
 | `id` | `string` | **Required.** Unique identifier within the dataset |
 | `label` | `string` | Human-readable name shown in the Layers and Key panels |
 | `filter` | `FilterExpression` | MapLibre filter expression to match features for this sublayer |
-| `style` | `Object` | Style overrides for this sublayer. Accepts the same properties as the dataset `style` object |
+| `style` | `Object` | Style overrides. Accepts the same properties as the dataset `style` object |
 | `showInKey` | `boolean` | Shows this sublayer in the Key panel. Inherits from dataset if not set |
 | `toggleVisibility` | `boolean` | Shows this sublayer in the Layers panel. **Default:** `false` |
 
+**Polygon/line example:**
+
 ```js
 sublayers: [
   {
@@ -334,6 +384,44 @@ sublayers: [
 ]
 ```
 
+**Symbol (point) example — scheduled monuments by type:**
+
+When the parent dataset has `symbol` set, each sublayer can override individual symbol properties to represent different categories. Properties not set on the sublayer are inherited from the parent.
+
+```js
+{
+  id: 'scheduled-monuments',
+  geojson: scheduledMonumentsData,
+  style: { symbol: 'square' },
+  sublayers: [
+    {
+      id: 'prehistoric',
+      label: 'Prehistoric sites',
+      filter: ['==', ['get', 'type'], 'prehistoric'],
+      showInKey: true,
+      toggleVisibility: true,
+      style: { symbolBackgroundColor: '#0f7a52' }
+    },
+    {
+      id: 'roman',
+      label: 'Roman sites',
+      filter: ['==', ['get', 'type'], 'roman'],
+      showInKey: true,
+      toggleVisibility: true,
+      style: { symbolBackgroundColor: '#54319f' }
+    },
+    {
+      id: 'medieval',
+      label: 'Medieval sites',
+      filter: ['==', ['get', 'type'], 'medieval'],
+      showInKey: true,
+      toggleVisibility: true,
+      style: { symbolBackgroundColor: '#ca357c' }
+    }
+  ]
+}
+```
+
 ---
 
 ## Methods
@@ -436,24 +524,32 @@ datasetsPlugin.setFeatureVisibility(true, [123, 456], {
 
 Update the visual style of a dataset or sublayer at runtime. When targeting a sublayer, only the properties specified are overridden — the sublayer inherits all other styles from the parent dataset.
 
+For symbol datasets, pass `symbol` as the style property to change the symbol config.
+
 | Argument | Type | Description |
 |----------|------|-------------|
-| `style` | `Object` | Style properties to apply. Accepts the same properties as `dataset.style` |
+| `style` | `Object` | Style properties to apply. Accepts the same properties as `dataset.style`, plus `symbol` |
 | `scope.datasetId` | `string` | ID of the dataset |
 | `scope.sublayerId` | `string` | Optional. When provided, targets a single sublayer |
 
 ```js
-// Dataset level
+// Polygon/line dataset
 datasetsPlugin.setStyle(
   { stroke: '#0000ff', strokeWidth: 3 },
   { datasetId: 'my-parcels' }
 )
 
-// Sublayer level
+// Sublayer — polygon
 datasetsPlugin.setStyle(
   { stroke: '#00703c', fillPattern: 'diagonal-cross-hatch', fillPatternForegroundColor: '#00703c' },
   { datasetId: 'my-parcels', sublayerId: 'active' }
 )
+
+// Sublayer — symbol colour override
+datasetsPlugin.setStyle(
+  { symbolBackgroundColor: '#912b88' },
+  { datasetId: 'flood-warnings', sublayerId: 'severe' }
+)
 ```
 
 ---

package/docs/plugins/interact.md

@@ -8,9 +8,9 @@ The interact plugin provides a unified way to handle user interactions for selec
 import createInteractPlugin from '@defra/interactive-map/plugins/interact'
 
 const interactPlugin = createInteractPlugin({
-  interactionMode: 'auto',
+  interactionModes: ['selectMarker', 'selectFeature'],
   multiSelect: true,
-  dataLayers: [
+  layers: [
     { layerId: 'my-layer', idProperty: 'id' }
   ]
 })
@@ -40,40 +40,61 @@ Array of mode identifiers. When set, the plugin does not render when the app is
 
 ---
 
-### `interactionMode`
-**Type:** `'marker' | 'select' | 'auto'`
-**Default:** `'marker'`
+### `interactionModes`
+**Type:** `Array<'selectMarker' | 'selectFeature' | 'placeMarker'>`
+**Default:** `['selectMarker']`
 
-Controls how user clicks are interpreted.
+Controls which interactions are active when the user clicks the map. Values can be combined freely — the plugin always processes them in a fixed priority order: marker selection → feature selection → place marker.
 
-- `'marker'` — clicking always places a location marker at the clicked coordinates
-- `'select'` — clicking attempts to match a feature from `dataLayers`; click outside clears selection (unless `deselectOnClickOutside` is `false`)
-- `'auto'` — attempts feature matching first, falls back to placing a marker if no feature is found
+- `'selectMarker'` — clicking a placed marker toggles its selection state
+- `'selectFeature'` — clicking the map attempts to match a feature from `layers`
+- `'placeMarker'` — if no feature is matched (or `selectFeature` is not active), places a location marker at the clicked coordinates
+
+**Common combinations:**
+
+```js
+interactionModes: ['selectMarker']                              // marker selection only (default)
+interactionModes: ['selectFeature']                             // feature selection only
+interactionModes: ['placeMarker']                               // always place a marker on click
+interactionModes: ['selectMarker', 'selectFeature']             // select markers or features
+interactionModes: ['selectFeature', 'placeMarker']              // select features, fall back to placing a marker
+interactionModes: ['selectMarker', 'selectFeature', 'placeMarker'] // all interactions active
+```
 
 ---
 
-### `dataLayers`
-**Type:** `Array<DataLayer>`
+### `layers`
+**Type:** `Array<LayerConfig>`
 **Default:** `[]`
 
 Array of map layer configurations that are selectable. Each entry specifies which layer to watch and how to identify features.
 
 ```js
-dataLayers: [
-  { layerId: 'my-polygons', idProperty: 'id' },
+layers: [
+  { layerId: 'my-polygons', idProperty: 'guid' },
   { layerId: 'my-lines' }
 ]
 ```
 
-#### `DataLayer` properties
+#### `LayerConfig` properties
 
 | Property | Type | Description |
 |----------|------|-------------|
 | `layerId` | `string` | **Required.** The map layer identifier to enable selection on |
 | `idProperty` | `string` | Property name used as the feature's unique identifier. If omitted, features are matched by index |
-| `selectedStroke` | `string` | Overrides the global `selectedStroke` for this layer |
-| `selectedFill` | `string` | Overrides the global `selectedFill` for this layer |
-| `selectedStrokeWidth` | `number` | Overrides the global `selectedStrokeWidth` for this layer |
+| `selectedStroke` | `string` | Overrides the selection stroke colour for this layer. Defaults to `MapStyleConfig.selectedColor` |
+| `selectedFill` | `string` | Overrides the selection fill colour for this layer. Defaults to `transparent` |
+| `selectedStrokeWidth` | `number` | Overrides the selection stroke width for this layer. Defaults to `3` |
+
+#### Finding layer IDs
+
+What to use as `layerId` depends on how your data is added to the map — these are the layers the plugin will enable for feature selection:
+
+- **Map provider directly** — use the layer IDs defined in your style or added via your map provider's layer API
+- **Datasets plugin** — use the dataset ID, or the sublayer ID for datasets with sublayers
+- **Draw plugin** — uses generated layer IDs; inspect the map at runtime to find them (e.g. `fill-inactive.cold`, `stroke-inactive.cold` when using MapLibre)
+
+If you're unsure of the layer IDs available at runtime, set `debug: true` in the interact plugin options — this lets you query the map and inspect layer names in the browser console.
 
 ---
 
@@ -97,7 +118,7 @@ When `true`, only features that touch or overlap the existing selection can be a
 **Type:** `boolean`
 **Default:** `false`
 
-When `true`, clicking outside any selectable layer clears the current selection.
+When `true`, clicking outside any selectable feature clears the current selection.
 
 ---
 
@@ -105,7 +126,7 @@ When `true`, clicking outside any selectable layer clears the current selection.
 **Type:** `number`
 **Default:** `10`
 
-Click detection radius in pixels. Increases the hit area around the cursor when matching features, which is useful for lines and points.
+Click detection radius in pixels applied to line features. Lines have a 1px rendered width so a buffer is required for reliable selection. Polygon and symbol/icon features use exact hit detection and are unaffected by this value.
 
 ---
 
@@ -117,35 +138,32 @@ When `true`, the app closes after the user clicks "Done" or "Cancel".
 
 ---
 
-### `markerColor`
-**Type:** `string`
-**Default:** `'rgba(212,53,28,1)'`
-
-Color of the location marker placed on the map.
-
----
+### `marker`
+**Type:** `MarkerOptions`
 
-### `selectedStroke`
-**Type:** `string`
-**Default:** `'rgba(212,53,28,1)'`
+Appearance of the location marker placed on the map. Accepts the same properties as [`MarkerOptions`](../api/marker-config.md#markeroptions). See [Symbol Config](../api/symbol-config.md) for the full property reference.
 
-Stroke color used to highlight selected features. Can be overridden per layer via `dataLayers`.
-
----
-
-### `selectedFill`
-**Type:** `string`
-**Default:** `'rgba(255, 0, 0, 0.1)'`
+```js
+createInteractPlugin({
+  marker: {
+    symbol: 'pin',
+    backgroundColor: { outdoor: '#d4351c', dark: '#ff6b6b' },
+    foregroundColor: '#ffffff'
+  }
+})
+```
 
-Fill color used to highlight selected features. Can be overridden per layer via `dataLayers`.
+When not set, the marker inherits from the constructor `symbolDefaults` cascade.
 
 ---
 
 ### `selectedStrokeWidth`
 **Type:** `number`
-**Default:** `2`
+**Default:** `3`
+
+Stroke width used to highlight selected features. Can be overridden per layer via `layers[].selectedStrokeWidth`.
 
-Stroke width used to highlight selected features. Can be overridden per layer via `dataLayers`.
+> **Selection colours** — stroke and fill colours for selected features are not configured here. Stroke colour comes from `MapStyleConfig.selectedColor` (falling back to the `mapColorScheme` scheme default), ensuring the selection colour stays consistent with the rest of the map theme. Fill defaults to `transparent`. Both can be overridden per layer via `layers[].selectedStroke` and `layers[].selectedFill`.
 
 ---
 
@@ -169,7 +187,7 @@ interactiveMap.on('map:ready', () => {
 })
 
 // Override options at runtime
-interactPlugin.enable({ multiSelect: true, interactionMode: 'select' })
+interactPlugin.enable({ multiSelect: true, interactionModes: ['selectFeature'] })
 ```
 
 ---
@@ -247,12 +265,15 @@ Emitted when the user confirms their selection (clicks "Done").
 **Payload:**
 ```js
 {
-  // If a marker was placed:
+  // If a location marker was placed:
   coords: [lng, lat],
 
   // If features were selected:
   selectedFeatures: [...],
-  selectionBounds: [west, south, east, north]
+  selectionBounds: [west, south, east, north],
+
+  // If markers were selected:
+  selectedMarkers: ['...']
 }
 ```
 
@@ -264,6 +285,9 @@ interactiveMap.on('interact:done', (e) => {
   if (e.selectedFeatures) {
     console.log('Features selected:', e.selectedFeatures)
   }
+  if (e.selectedMarkers) {
+    console.log('Markers selected:', e.selectedMarkers)
+  }
 })
 ```
 
@@ -285,7 +309,7 @@ interactiveMap.on('interact:cancel', () => {
 
 ### `interact:selectionchange`
 
-Emitted whenever the feature selection changes.
+Emitted whenever the selected features or selected markers change.
 
 **Payload:**
 ```js
@@ -293,6 +317,7 @@ Emitted whenever the feature selection changes.
   selectedFeatures: [
     { featureId: '...', layerId: '...', properties: {...}, geometry: {...} }
   ],
+  selectedMarkers: ['...'],  // array of selected marker IDs
   selectionBounds: [west, south, east, north] | null,
   canMerge: boolean,  // true when all selected features are contiguous
   canSplit: boolean   // true when exactly one Polygon or MultiPolygon is selected

package/docs/plugins/search.md

@@ -90,10 +90,22 @@ Whether to place a marker on the map when a search result is selected.
 
 ---
 
-### `markerColor`
-**Type:** `string`
+### `marker`
+**Type:** `MarkerOptions`
+
+Appearance of the marker placed when a search result is selected. Accepts the same properties as [`MarkerOptions`](../api/marker-config.md#markeroptions). See [Symbol Config](../api/symbol-config.md) for the full property reference.
+
+```js
+searchPlugin({
+  showMarker: true,
+  marker: {
+    symbol: 'circle',
+    backgroundColor: { outdoor: '#1d70b8', dark: '#5694ca' }
+  }
+})
+```
 
-Colour of the search result marker.
+When not set, the marker inherits from the constructor `symbolDefaults` cascade.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defra/interactive-map",
-  "version": "0.0.17-alpha",
+  "version": "0.0.18-alpha",
   "description": "An accessible map component",
   "repository": {
     "type": "git",