@tomtom-org/maps-sdk 0.60.0 → 0.61.0

package/map/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { AllLayoutProperties, AllPaintProperties, BackgroundLayerSpecification, CircleLayerSpecification, DataDrivenPropertyValueSpecification, ExpressionFilterSpecification, ExpressionSpecification, FilterSpecification, GeoJSONSource, GeoJSONSourceSpecification, LayerSpecification, LineLayerSpecification, LngLat, Map as Map$1, MapGeoJSONFeature, MapOptions, Source, SourceSpecification, StyleImageInterface, StyleImageMetadata, StyleSpecification, SymbolLayerSpecification } from "maplibre-gl";
-import { Anything, AreaAnalyticsMetricKey, AreaAnalyticsMetrics, BBox, ChargingSpeed, ChargingStop, ChargingStopProps, CommonPlaceProps, CountrySectionProps, DelayMagnitude, DisplayUnits, EntryPoint, GetPositionEntryPointOption, GlobalConfig, Instruction, Language, POICategory, Place, Places, PolygonFeature, PolygonFeatures, Route, RouteProps, Routes, SectionProps, SectionType, TrafficAreaAnalytics, TrafficIncident, TrafficIncidentBaseProperties, TrafficIncidentCategory, TrafficIncidentDetails, TrafficIncidentTimeValidity, TrafficSectionProps, Waypoint, WaypointLike, Waypoints } from "@tomtom-org/maps-sdk/core";
+import { Anything, AreaAnalyticsMetricKey, AreaAnalyticsMetrics, BBox, ChargingSpeed, ChargingStop, ChargingStopProps, CommonPlaceProps, CountrySectionProps, DelayMagnitude, DisplayUnits, DistanceDisplayUnits, EntryPoint, GeopoliticalView, GetPositionEntryPointOption, GlobalConfig, Instruction, Language, POICategory, Place, Places, PolygonFeature, PolygonFeatures, Route, RouteProps, Routes, SectionProps, SectionType, TimeDisplayUnits, TrafficAreaAnalytics, TrafficIncident, TrafficIncidentBaseProperties, TrafficIncidentCategory, TrafficIncidentDetails, TrafficIncidentTimeValidity, TrafficSectionProps, Waypoint, WaypointLike, Waypoints } from "@tomtom-org/maps-sdk/core";
 //#region src/init/types/mapEventsConfig.d.ts
 /**
  * Configuration options for map user event handling.
@@ -980,7 +980,7 @@ type StylingKnobAppliesTo = (typeof stylingKnobAppliesTo)[number];
  *
  * @group Map Styling
  */
-type StylingKnobValue = number | boolean | string;
+type StylingKnobValue = KnobValueOf<StylingKnobKind>;
 /**
  * The valid range of a numeric knob, in the units of the knob (`factor` knobs are unitless).
  * Styling always ships a slider `step`; the shared {@link KnobRange} leaves it optional.
@@ -992,20 +992,16 @@ type StylingKnobRange = KnobRange & {
 };
 /**
  * One entry of {@link stylingKnobCatalogue}: what a UI or a coding agent needs to offer the knob and
- * validate a value for it, with no map loaded. The value in force is {@link StylingModule.get}.
+ * validate a value for it, with no map loaded. It carries no `default`: the loaded style decides,
+ * and {@link StylingModule.get} reads the value in force.
  *
  * @group Map Styling
  */
-type StylingKnob = {
+type StylingKnob = KnobEntry<StylingKnobId, StylingKnobKind> & {
   /** The knob's id, as accepted by {@link StylingModule.set}. */
   id: StylingKnobId;
-  kind: StylingKnobKind;
-  /** One line on what turning the knob does. */
-  description: string;
-  /** The range of valid values, for `factor` and `number` knobs. */
   range?: StylingKnobRange;
-  /** The valid values, for `enum` knobs. */
-  options?: readonly string[];
+  default?: never;
   /** Which styles the knob works on; see {@link stylingKnobAppliesTo}. */
   appliesTo: StylingKnobAppliesTo;
 };
@@ -1137,19 +1133,11 @@ type KnobMechanism =
 {
   type: 'published';
 };
-/** @ignore */
-type KnobDefinition = {
-  kind: StylingKnobKind;
-  description: string;
+type KnobDefinitionOf<KIND extends StylingKnobKind> = Omit<KnobEntry<string, KIND>, 'id' | 'default'> & {
   range?: StylingKnobRange;
-  /** The valid values of an `enum` knob. */
-  options?: readonly string[];
   appliesTo: StylingKnobAppliesTo;
   mechanisms: KnobMechanism[];
 };
-type KnobDefinitionOf<KIND extends StylingKnobKind> = KnobDefinition & {
-  kind: KIND;
-};
 /**
  * The styling knob catalogue: what the SDK can restyle on a TomTom standard style, and how.
  *
@@ -1176,6 +1164,7 @@ declare const knobDefinitions: {
       readonly min: 0;
       readonly max: 359;
       readonly step: 1;
+      readonly bounds: "hard";
     };
     readonly appliesTo: "tomtom-styles";
     readonly mechanisms: [{
@@ -1191,6 +1180,7 @@ declare const knobDefinitions: {
       readonly min: 0;
       readonly max: 1;
       readonly step: 0.05;
+      readonly bounds: "hard";
     };
     readonly appliesTo: "tomtom-styles";
     readonly mechanisms: [{
@@ -1206,6 +1196,7 @@ declare const knobDefinitions: {
       readonly min: 10;
       readonly max: 22;
       readonly step: 1;
+      readonly bounds: "hard";
     };
     readonly appliesTo: "tomtom-styles";
     readonly mechanisms: [{
@@ -1283,6 +1274,7 @@ declare const knobDefinitions: {
       readonly min: 3;
       readonly max: 18;
       readonly step: 1;
+      readonly bounds: "hard";
     };
     readonly appliesTo: "tomtom-styles";
     readonly mechanisms: [{
@@ -1305,6 +1297,7 @@ declare const knobDefinitions: {
       readonly min: -3;
       readonly max: 3;
       readonly step: 1;
+      readonly bounds: "hard";
     };
     readonly appliesTo: "tomtom-styles";
     readonly mechanisms: [{
@@ -1385,13 +1378,12 @@ type StylingColorKnobId = { [ID in StylingKnobId]: (typeof knobDefinitions)[ID][
  * @group Map Styling
  */
 export declare const stylingColorKnobIds: StylingColorKnobId[];
-type ValueOfKind<KIND extends StylingKnobKind> = KIND extends 'toggle' ? boolean : KIND extends 'color' | 'enum' ? string : number;
 /**
  * The value type a given styling knob takes.
  *
  * @group Map Styling
  */
-type StylingKnobValueOf<ID extends StylingKnobId> = ValueOfKind<(typeof knobDefinitions)[ID]['kind']>;
+type StylingKnobValueOf<ID extends StylingKnobId> = KnobValueOf<(typeof knobDefinitions)[ID]['kind']>;
 //#endregion
 //#region src/shared/layers/abstractLayerComposer.d.ts
 /**
@@ -1758,6 +1750,7 @@ export declare class StylingModule extends AbstractStyleOwnedMapModule<Record<st
    * ```
    */
   reset(id?: StylingKnobId): void;
+  private publish;
   private publishMapColors;
   /**
    * Recolours the whole base map with up to ten semantic colours in one call — the style themes'
@@ -1834,7 +1827,6 @@ export declare class StylingModule extends AbstractStyleOwnedMapModule<Record<st
   private defaultOf;
   private mapLevelDefaultOf;
   private assertKnob;
-  private validate;
   private warnOnce;
 }
 //#endregion
@@ -1956,8 +1948,8 @@ export type SetStyleOptions = {
    * - `true`: a clean switch. Modules re-bind to the new style with default configuration and
    *   nothing shown, and only the style parts named in the new style input are loaded.
    *
-   * The map language is not SDK state: it is re-applied in both cases, and only
-   * {@link TomTomMap.setLanguage} changes it.
+   * The map language and geopolitical view are not SDK state: both survive either case, and only
+   * {@link TomTomMap.setLanguage} and {@link TomTomMap.setGeopoliticalView} change them.
    *
    * Registered {@link StyleChangeHandler}s run in both cases and receive the value in their
    * {@link StyleChangeContext}.
@@ -1978,6 +1970,7 @@ export type SetStyleOptions = {
  * - Seamless style switching without map reload
  * - Integrated event handling system
  * - Multi-language support with dynamic switching
+ * - Geopolitical views of disputed borders and names, switchable at runtime
  * - Compatible with TomTom map modules (traffic, POIs, routing, etc.)
  *
  * **Architecture:**
@@ -2151,6 +2144,26 @@ export declare class TomTomMap {
    * @ignore
    */
   _onMapColorsChange(handler: (colors: Readonly<MapColors>) => void): void;
+  private stylingSettings;
+  private readonly stylingAppliedHandlers;
+  /**
+   * The knobs in force, as the {@link StylingModule} last applied them. Empty until a styling module exists.
+   * @ignore
+   */
+  get _stylingSettings(): Readonly<StylingSettings>;
+  /**
+   * Publishes the knobs in force; the styling module calls this each time it has applied knobs to
+   * the loaded style, with the ids of those it rewrote or whose value moved.
+   * @ignore
+   */
+  _setStylingSettings(settings: StylingSettings, knobIds: ReadonlySet<StylingKnobId>): void;
+  /**
+   * Runs `handler` each time the styling module has applied knobs to the loaded style — after any
+   * knob change and after every style change — for as long as the map lives. It is how a module
+   * drawing its own layers in a look borrowed from the style's follows the knobs that restyle it.
+   * @ignore
+   */
+  _onStylingApplied(handler: (knobIds: ReadonlySet<StylingKnobId>) => void): void;
   private readonly styleChangeHandlers;
   private styleGivenToMapLibre;
   private styleRequestSequence;
@@ -2213,8 +2226,6 @@ export declare class TomTomMap {
    * });
    * ```
    *
-   * @throws Will log errors if RTL text plugin fails to load (non-blocking)
-   *
    * @see {@link MapLibreOptions}
    * @see {@link TomTomMapParams}
    * @see {@link https://maplibre.org/maplibre-gl-js/docs/API/classes/Map/ | MapLibre Map Parameters}
@@ -2223,11 +2234,6 @@ export declare class TomTomMap {
    * @see [User Interaction Events Guide](https://docs.tomtom.com/maps-sdk-js/guides/map/user-events)
    */
   constructor(mapParams: TomTomMapParams);
-  private loadRTLTextPlugin;
-  /**
-   * Dynamically loads the MapLibre CSS stylesheet from CDN.
-   */
-  private ensureMapLibreCSSLoaded;
   /**
    * Changes the map style dynamically without reloading the entire map.
    *
@@ -2425,6 +2431,20 @@ export declare class TomTomMap {
    * @see {@link https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes | ISO 639-1 Language Codes}
    */
   setLanguage(language: Language): void;
+  /**
+   * Changes the geopolitical view of the map: the borders, and the territory and sea names, it
+   * draws for disputed territories.
+   *
+   * @param geopoliticalView The view to draw, or `undefined` for the default view of the country
+   * the map is viewed from. Set it at construction through {@link core!GlobalConfig.geopoliticalView}.
+   *
+   * @remarks
+   * - The visible tiles reload in place, and the view persists across every style change.
+   * - Applies to the TomTom Orbis vector tiles, those of a custom style included. The tiles do not
+   *   serve `CN` and `RU`, which leave the default view; see {@link core!GeopoliticalView}.
+   * - Services keep the view of the global configuration, or of each call.
+   */
+  setGeopoliticalView(geopoliticalView: GeopoliticalView | undefined): void;
   /**
    * Changes the map's user events configuration at runtime.
    *
@@ -3942,6 +3962,15 @@ type CustomImage<I extends string = string> = {
    */
   offsetY?: number;
 };
+/**
+ * A {@link CustomImage} that survives JSON: its `image` a URL, data URI or SVG text. `JSON.stringify`
+ * turns an `HTMLImageElement` into `{}`.
+ *
+ * @group Shared
+ */
+type SerializableCustomImage<I extends string = string> = Omit<CustomImage<I>, 'image'> & {
+  image?: Exclude<CustomImage['image'], HTMLImageElement>;
+};
 /**
  * Options to style SDK SVG icons with custom colors and opacity.
  *
@@ -5499,12 +5528,16 @@ export declare abstract class AbstractMapModule<SOURCES_WITH_LAYERS extends Sour
  * Owning the data brings the duty this class states: a clean style switch must forget the data
  * the module remembers having shown, through {@link discardShownData}.
  *
+ * Every such module hides and shows through {@link setVisible}, which keeps the data it shows.
+ *
  * @typeParam SOURCES_WITH_LAYERS - The GeoJSON sources, with their layers, this module owns
  * @typeParam CFG - The configuration type for this module, or undefined if no configuration is needed
  *
  * @group Shared
  */
-export declare abstract class AbstractDataOwnedMapModule<SOURCES_WITH_LAYERS extends GeoJSONSourcesWithLayers, CFG extends MapModuleCommonConfig | undefined = undefined> extends AbstractMapModule<SOURCES_WITH_LAYERS, CFG> {
+export declare abstract class AbstractDataOwnedMapModule<SOURCES_WITH_LAYERS extends GeoJSONSourcesWithLayers, CFG extends (MapModuleCommonConfig & {
+  visible?: boolean;
+}) | undefined = undefined> extends AbstractMapModule<SOURCES_WITH_LAYERS, CFG> {
   /**
    * Owning the data it draws, such a module always remembers something a clean style switch must
    * forget, so the inherited no-op becomes a duty here. A module that remembers nothing
@@ -5513,6 +5546,37 @@ export declare abstract class AbstractDataOwnedMapModule<SOURCES_WITH_LAYERS ext
    * @ignore
    */
   protected abstract discardShownData(): void;
+  /**
+   * Shows or hides the layers of everything shown, per `config.visible` and whether each part has
+   * data. `config` is passed rather than read, because `_applyConfig` runs before `this.config`
+   * holds the new configuration.
+   * @protected
+   * @ignore
+   */
+  protected abstract applyVisibility(config: CFG | undefined): void;
+  /**
+   * Shows or hides everything the module draws.
+   *
+   * @remarks
+   * Stored as `visible` in the configuration. Showing and clearing data never change it: a hidden
+   * module keeps its data, through style changes too, and draws it again on `setVisible(true)`.
+   *
+   * Showing leaves hidden what the configuration turns off: a route section type that is off, the
+   * layers a place marker type does not use.
+   *
+   * @example
+   * ```typescript
+   * module.setVisible(false);
+   * await module.show(data); // stays hidden
+   * module.setVisible(true);
+   * ```
+   */
+  setVisible(visible: boolean): void;
+  /**
+   * Whether the module is set to be shown: its `visible` setting, `true` unless set. A shown
+   * module with nothing shown draws nothing; `getShown()` returns what is shown.
+   */
+  isVisible(): boolean;
 }
 //#endregion
 //#region src/shared/layers/layerVisibilityComposer.d.ts
@@ -5591,16 +5655,29 @@ export declare abstract class AbstractStyleOwnedMapModule<SOURCES_WITH_LAYERS ex
  * - `toggle`: `true`/`false`, e.g. whether an overlay is drawn.
  * - `factor`: a multiplier over what the style already does (`1` = unchanged).
  * - `number`: an absolute number with a range.
+ * - `offset`: an `[x, y]` displacement on screen, x to the right and y down, each within the
+ *   knob's range; the description gives the unit.
  * - `color`: a CSS colour string.
  * - `enum`: one of the knob's `options`.
+ * - `enums`: a list of the knob's `options`, e.g. the categories a filter shows. The description
+ *   says when the order matters.
  * - `colors`: a list of colours, each a CSS colour string or one of the knob's `options` — names
  *   the module resolves to colours, such as styling knob ids. An empty list is the knob's default.
+ * - `image`: the id of an image in the loaded style's sprite, e.g. `poi-toll_plaza`.
+ * - `text`: any string, e.g. the label written after a distance.
  * @group Shared
  */
-export type KnobKind = 'toggle' | 'factor' | 'number' | 'color' | 'enum' | 'colors';
+export type KnobKind = 'toggle' | 'factor' | 'number' | 'offset' | 'color' | 'enum' | 'enums' | 'colors' | 'image' | 'text';
 /**
- * Inclusive bounds for a `factor` or `number` knob. `step` is what a slider would use; some ranges
- * (e.g. opacity 0–1) have no natural step and omit it.
+ * Inclusive bounds for a `factor`, `number` or `offset` knob, on an `offset` for each of x and y.
+ * `step` is what a slider would use.
+ *
+ * @remarks
+ * `bounds` says which ends a value must keep to, as {@link validateKnobValue} checks:
+ * - `hard`: both, e.g. an opacity or a factor. Outside them the value is invalid.
+ * - `hard-min`: `min` is a floor, e.g. no height below 0 m; `max` is where a control's span ends,
+ *   and a larger value still applies.
+ * - `soft`: neither; the range is the span a control offers, and any number applies.
  *
  * @group Shared
  */
@@ -5608,7 +5685,105 @@ export type KnobRange = {
   min: number;
   max: number;
   step?: number;
+  bounds: 'hard' | 'hard-min' | 'soft';
 };
+/**
+ * The value a knob of the given {@link KnobKind} holds.
+ *
+ * @group Shared
+ */
+export type KnobValueOf<KIND extends KnobKind> = KIND extends 'toggle' ? boolean : KIND extends 'factor' | 'number' ? number : KIND extends 'offset' ? readonly [x: number, y: number] : KIND extends 'colors' | 'enums' ? readonly string[] : string;
+/**
+ * One entry of a knob catalogue: what a UI or a coding agent needs to offer a knob and validate a
+ * value for it, with no map loaded. A catalogue may add fields of its own.
+ *
+ * @remarks
+ * One union member per kind: a `factor`, `number` or `offset` knob always carries its `range`, an
+ * `enum` or `enums` knob its `options`, and a `colors` knob may carry the names it resolves.
+ *
+ * @group Shared
+ */
+export type KnobEntry<ID extends string, KIND extends KnobKind = KnobKind> = KIND extends KnobKind ? {
+  /** The knob's id, unique within its catalogue. */
+  id: ID;
+  kind: KIND;
+  /** One line on what turning the knob does. */
+  description: string;
+  /** The value in force when nothing sets the knob, where one value holds everywhere. */
+  default?: KnobValueOf<KIND>;
+} & (KIND extends 'factor' | 'number' | 'offset' ? {
+  range: KnobRange;
+  options?: never;
+} : KIND extends 'enum' | 'enums' ? {
+  range?: never;
+  options: readonly string[];
+} : KIND extends 'colors' ? {
+  range?: never;
+  options?: readonly string[];
+} : {
+  range?: never;
+  options?: never;
+}) : never;
+//#endregion
+//#region src/shared/knobUtils.d.ts
+type ElementAt<T, KEY extends string> = T extends readonly (infer ELEMENT)[] ? KEY extends `${number}` ? ELEMENT : never : never;
+/**
+ * The value at a dotted path into T, or `never` where the path names nothing. A union is read
+ * member by member, so `focus.widthFactor` resolves through `false | IncidentFocusStyle`, and a
+ * numeric segment indexes a list.
+ * @ignore
+ */
+type ValueAt<T, PATH extends string> = T extends unknown ? PATH extends `${infer HEAD}.${infer REST}` ? HEAD extends keyof T ? ValueAt<NonNullable<T[HEAD]>, REST> : ValueAt<NonNullable<ElementAt<T, HEAD>>, REST> : PATH extends keyof T ? NonNullable<T[PATH]> : NonNullable<ElementAt<T, PATH>> : never;
+/**
+ * The alternatives of VALUE a knob holds: plain values, lists and `[x, y]` pairs, without the
+ * objects, MapLibre expressions and callbacks the config also takes there.
+ * @ignore
+ */
+type KnobPlainValue<VALUE> = VALUE extends ExpressionSpecification ? never : VALUE extends readonly unknown[] ? VALUE : VALUE extends object ? never : VALUE;
+//#endregion
+//#region src/shared/knobValues.d.ts
+/**
+ * Checks a value against a catalogue entry: its kind, its options, and its range as far as the
+ * range's `bounds` hold.
+ *
+ * @remarks
+ * A `color` must parse as a CSS colour. An `image` or `text` value need only be a string; whether
+ * the sprite has the image is known on a loaded map only.
+ *
+ * @param knob - The knob's entry in its catalogue.
+ * @throws `RangeError` naming the knob and what it expects, for a value it does not take.
+ *
+ * @example
+ * ```typescript
+ * const knob = trafficIncidentsKnobCatalogue.find(({ id }) => id === 'filters.any.0.magnitudes.values');
+ * validateKnobValue(knob, ['major', 'severe']); // RangeError: … 'severe' is not
+ * ```
+ *
+ * @group Shared
+ */
+export declare const validateKnobValue: (knob: KnobEntry<string>, value: unknown) => void;
+/**
+ * Sets one knob of a module by its catalogue id: checks the value with {@link validateKnobValue},
+ * then applies the module's configuration with the value at the knob's path and every other
+ * setting kept.
+ *
+ * @remarks
+ * Nothing changes when the value is invalid. `StylingModule` sets its knobs with its own `set`.
+ *
+ * @param catalogue - The module's knob catalogue, e.g. `trafficFlowKnobCatalogue` for a
+ * `TrafficFlowModule`.
+ * @param id - The knob's id, its path in the module's configuration.
+ * @throws `RangeError` for a value the knob does not take; `Error` for an id the catalogue lacks.
+ *
+ * @example
+ * ```typescript
+ * setKnob(trafficFlow, trafficFlowKnobCatalogue, 'filters.any.0.roadCategories.show', 'only');
+ * setKnob(analytics, trafficAreaAnalyticsKnobCatalogue, 'metricConfig.speed.height.maxHeightMeters', 2000);
+ * ```
+ *
+ * @group Shared
+ */
+export declare const setKnob: <CONFIG extends MapModuleCommonConfig, ID extends string, KNOB extends ID>(module: Pick<AbstractMapModule<SourcesWithLayers, CONFIG>, "getConfig" | "applyConfig">, catalogue: readonly KnobEntry<ID>[], id: KNOB, value: KnobPlainValue<ValueAt<CONFIG, KNOB>>) => void;
 //#endregion
 //#region src/shared/layers/sourcesIDs.d.ts
 /**
@@ -5749,6 +5924,7 @@ export type BaseMapEvents = CombinedEvents<MapGeoJSONFeature, BaseMapModuleConfi
  * toggles within a group (`roads.arrows`, `roads.exitNumbers`, …) hide their layers inside what this
  * module shows, and never show them in a group it hides.
  * See [Who owns what](https://docs.tomtom.com/maps-sdk-js/guides/map/modules#who-owns-what).
+ * {@link baseMapKnobCatalogue} lists every setting of its configuration.
  *
  * **Managed Layers:**
  * - Background and land cover
@@ -5888,20 +6064,21 @@ export declare class BaseMapModule extends AbstractStyleOwnedMapModule<BaseSourc
    */
   protected _applyConfig(config: BaseMapModuleConfig | undefined): BaseMapModuleConfig | undefined;
   /**
-   * Checks if any base map layers are currently visible.
+   * Whether the base map, or the layer groups asked about, is set to be shown.
    *
    * @param options - Optional settings for fine-grained control.
    * @param options.layerGroups - Ask about specific layer groups instead of all layers.
    *
-   * @returns `true` if at least one of the layers asked about is visible, `false` if all are
-   * hidden.
+   * @returns `true` if at least one of the layers asked about is set to show, `false` if all are
+   * set to hide.
    *
    * @remarks
-   * This checks the actual visibility state of layers in the map, not just the
-   * module's configuration setting.
+   * Reads the settings, not the map: `visible`, then the `groups` and the {@link StylingModule}
+   * toggles over them, the last that reaches a layer winning — the same order {@link setVisible}
+   * writes them in.
    *
-   * Mirrors {@link setVisible}, so a group toggled through one can be read back through the
-   * other — which is how a per-group control reflects the state the style actually starts in.
+   * A layer none of them reaches answers with what the style draws, which is how a per-group
+   * control reflects the state the style starts in.
    *
    * @example
    * ```typescript
@@ -5999,6 +6176,7 @@ export declare class BaseMapModule extends AbstractStyleOwnedMapModule<BaseSourc
    */
   _onGroupsTakenOver(listener: (groups: readonly BaseMapLayerGroupName[]) => void): void;
   private writeVisibility;
+  private layerSettings;
   /**
    * The base-map layer ids grouped by {@link BaseMapLayerGroupName}, for the
    * layers this module manages in the current style.
@@ -6059,6 +6237,53 @@ export declare class BaseMapModule extends AbstractStyleOwnedMapModule<BaseSourc
   get events(): BaseMapEvents;
 }
 //#endregion
+//#region src/base/types/baseMapKnobs.d.ts
+/**
+ * The id of a base-map knob: its path into {@link BaseMapModuleConfig}, e.g. `visible` or
+ * `groups.water.visible`. See {@link baseMapKnobCatalogue} for what each one does.
+ *
+ * @remarks
+ * Every {@link BaseMapLayerGroupName} contributes one `groups.<group>.visible` id.
+ *
+ * @group Base Map
+ */
+type BaseMapKnobId = 'visible' | `groups.${BaseMapLayerGroupName}.visible`;
+/**
+ * The value type a given base-map knob takes: the plain value its path holds in {@link BaseMapModuleConfig}.
+ *
+ * @group Base Map
+ */
+type BaseMapKnobValueOf<ID extends BaseMapKnobId> = KnobPlainValue<ValueAt<BaseMapModuleConfig, ID>>;
+/**
+ * One entry of {@link baseMapKnobCatalogue}. The value in force is the one at its path in
+ * {@link BaseMapModule.getConfig}; with none, the style decides.
+ *
+ * @group Base Map
+ */
+type BaseMapKnob = KnobEntry<BaseMapKnobId, 'toggle'>;
+//#endregion
+//#region src/base/knobCatalogue.d.ts
+/**
+ * Every base-map knob with its kind and description: `visible`, then one toggle per layer group in
+ * {@link baseMapLayerGroupNames} order. Static data, readable with no map loaded.
+ *
+ * @remarks
+ * A knob is a plain display value in {@link BaseMapModuleConfig}, at the path its id names. None
+ * carries a `default`: unset, a layer is drawn as the style ships it, and some groups ship hidden.
+ *
+ * The `basemap.<group>`, `buildings.footprints`, `buildings.3d` and `roads.shields`
+ * {@link StylingModule} knobs toggle the same groups through this module. Not knobs: `events`.
+ *
+ * @group Base Map
+ */
+export declare const baseMapKnobCatalogue: readonly BaseMapKnob[];
+/**
+ * Every base-map knob id, in catalogue order.
+ *
+ * @group Base Map
+ */
+export declare const baseMapKnobIds: readonly BaseMapKnobId[];
+//#endregion
 //#region src/custom/types/customGeoJSONModuleConfig.d.ts
 type DistributiveOmit<T, K extends string> = T extends unknown ? Omit<T, K> : never;
 /**
@@ -6164,6 +6389,8 @@ export type CustomGeoJSONSourceSpec = {
  * };
  * ```
  *
+ * @see {@link CustomGeoJSONModuleSerializableConfig} for the part that survives JSON.
+ *
  * @group Custom
  */
 export type CustomGeoJSONModuleConfig<TSources extends Record<string, FeatureCollection> = Record<string, FeatureCollection>> = MapModuleCommonConfig & {
@@ -6206,16 +6433,34 @@ export type CustomGeoJSONModuleConfig<TSources extends Record<string, FeatureCol
    */
   images?: Record<string, CustomGeoJSONImageSpec>;
   /**
-   * Initial visibility for all layers across all sources. Defaults to `true`.
+   * Whether the module draws anything: every layer of every source.
    *
    * @remarks
-   * After `show(name, data)` is called for a source, layer visibility follows the
-   * data state (visible iff the feature collection is non-empty). Use
-   * {@link CustomGeoJSONModule.setVisible} to override that automatic behaviour at
-   * runtime.
+   * A shown source draws its layers while it holds features. `show()` and `clear()` never change
+   * this — a hidden module keeps its data until {@link CustomGeoJSONModule.setVisible} shows it again.
+   *
+   * @default true
    */
   visible?: boolean;
 };
+/**
+ * The part of a {@link CustomGeoJSONModuleConfig} that survives JSON, for saving
+ * `getConfig()` and replaying it with `applyConfig()`.
+ *
+ * @remarks
+ * It leaves out `images`: no {@link CustomGeoJSONImageData} survives JSON, so a replay passes them again.
+ *
+ * @example
+ * ```typescript
+ * const saved = JSON.stringify({ ...custom.getConfig(), images: undefined });
+ *
+ * const state: CustomGeoJSONModuleSerializableConfig = JSON.parse(saved);
+ * custom.applyConfig({ ...state, images: markerImages });
+ * ```
+ *
+ * @group Custom
+ */
+export type CustomGeoJSONModuleSerializableConfig<TSources extends Record<string, FeatureCollection> = Record<string, FeatureCollection>> = Omit<CustomGeoJSONModuleConfig<TSources>, 'images'>;
 //#endregion
 //#region src/custom/CustomGeoJSONModule.d.ts
 type CustomGeoJSONSourcesWithLayers<TSources extends Record<string, FeatureCollection>> = { [K in keyof TSources]: GeoJSONSourceWithLayers<TSources[K]>; };
@@ -6252,6 +6497,7 @@ export type CustomGeoJSONEvents<TSources extends Record<string, FeatureCollectio
  * Because the sources and layers are caller-supplied, the module has no built-in defaults:
  * `resetConfig()` (or `applyConfig(undefined)`) returns to the configuration passed to
  * {@link CustomGeoJSONModule.create | create}, and `getConfig()` never becomes `undefined`.
+ * {@link customGeoJSONKnobCatalogue} lists the settings of its configuration a knob holds.
  *
  * @typeParam TSources - A record mapping source names to the {@link FeatureCollection}
  * type each source carries. Pass this generic when you want type-safe `show` /
@@ -6338,7 +6584,8 @@ export declare class CustomGeoJSONModule<TSources extends Record<string, Feature
    */
   protected _applyConfig(config: CustomGeoJSONModuleConfig<TSources> | undefined): CustomGeoJSONModuleConfig<TSources> | undefined;
   private updateLayersForExistingSources;
-  private applyVisibility;
+  /** @ignore */
+  protected applyVisibility(config: CustomGeoJSONModuleConfig<TSources> | undefined): void;
   /**
    * @ignore
    */
@@ -6351,8 +6598,8 @@ export declare class CustomGeoJSONModule<TSources extends Record<string, Feature
    * Displays the given GeoJSON data on the named source — or on every source when
    * no name is supplied.
    *
-   * Replaces any previously shown data. Layer visibility is set automatically based
-   * on whether the feature collection is non-empty.
+   * Replaces any previously shown data. The source's layers draw while it holds features and
+   * the module is visible ({@link CustomGeoJSONModuleConfig.visible}).
    *
    * @param data The GeoJSON feature collection to display.
    * @param sourceName The source name (must match a key from
@@ -6373,15 +6620,6 @@ export declare class CustomGeoJSONModule<TSources extends Record<string, Feature
    * feature collection that `GeoJSONSourceWithLayers` keeps as initial state.
    */
   getShown(): { [K in keyof TSources]: TSources[K]; };
-  /**
-   * Toggles visibility of every layer across every source.
-   *
-   * @remarks
-   * Calling {@link show} on a source after `setVisible(false)` will re-reveal that
-   * source's layers via `GeoJSONSourceWithLayers`' automatic visibility behaviour.
-   * To keep a source hidden, call `setVisible(false)` after the next `show`.
-   */
-  setVisible(visible: boolean): void;
   /**
    * Per-source events surface.
    *
@@ -6404,6 +6642,56 @@ export declare class CustomGeoJSONModule<TSources extends Record<string, Feature
   get events(): CustomGeoJSONEvents<TSources>;
 }
 //#endregion
+//#region src/custom/types/customGeoJSONKnobs.d.ts
+/**
+ * The id of a custom GeoJSON knob: its path into {@link CustomGeoJSONModuleConfig}. See
+ * {@link customGeoJSONKnobCatalogue} for what each one does.
+ *
+ * @remarks
+ * Every setting but `sources` and `images`, which hold the caller's own MapLibre layers, source
+ * options and images rather than plain values.
+ *
+ * @group Custom
+ */
+type CustomGeoJSONKnobId = Exclude<keyof CustomGeoJSONModuleConfig, 'sources' | 'images' | keyof MapModuleCommonConfig>;
+/**
+ * The value type a given custom GeoJSON knob takes: the plain value its path holds in
+ * {@link CustomGeoJSONModuleConfig}.
+ *
+ * @group Custom
+ */
+type CustomGeoJSONKnobValueOf<ID extends CustomGeoJSONKnobId> = KnobPlainValue<ValueAt<CustomGeoJSONModuleConfig, ID>>;
+/**
+ * One entry of {@link customGeoJSONKnobCatalogue}. The value in force is the one at its path in
+ * {@link CustomGeoJSONModule.getConfig}, else its `default`.
+ *
+ * @group Custom
+ */
+type CustomGeoJSONKnob = KnobEntry<CustomGeoJSONKnobId, 'toggle'>;
+//#endregion
+//#region src/custom/knobCatalogue.d.ts
+/**
+ * Every custom GeoJSON knob with its kind, description and default. Static data, readable with no
+ * map loaded.
+ *
+ * @remarks
+ * A knob is a plain display value in {@link CustomGeoJSONModuleConfig}, at the path its id names.
+ * How the module draws is the caller's own MapLibre styling, so `visible` is the only one. Not knobs:
+ * - each source's `layers`, raw MapLibre layer specs passed through untouched;
+ * - each source's `cluster`, MapLibre source options forwarded verbatim and fixed at creation, and
+ *   its `sourceID`, a name;
+ * - `images`, image payloads; and `events`.
+ *
+ * @group Custom
+ */
+export declare const customGeoJSONKnobCatalogue: readonly CustomGeoJSONKnob[];
+/**
+ * Every custom GeoJSON knob id, in catalogue order.
+ *
+ * @group Custom
+ */
+export declare const customGeoJSONKnobIds: readonly CustomGeoJSONKnobId[];
+//#endregion
 //#region src/geometry/layers/colorPalettes.d.ts
 export declare const colorPalettes: {
   warm: string[];
@@ -6461,8 +6749,8 @@ export declare const geometryFillStyles: readonly ["filled", "outline", "inverte
  * // Solid color with opacity
  * const fill: GeometryFillConfig = { color: '#FF5733', opacity: 0.3 };
  *
- * // Palette name
- * const fill: GeometryFillConfig = { color: 'blues', opacity: 0.25 };
+ * // One colour per feature, in turn, from a palette
+ * const fill: GeometryFillConfig = { palette: 'blues', opacity: 0.25 };
  *
  * // Data-driven color based on properties
  * const fill: GeometryFillConfig = {
@@ -6475,15 +6763,23 @@ export declare const geometryFillStyles: readonly ["filled", "outline", "inverte
  */
 export type GeometryFillConfig = {
   /**
-   * Fill color: a hex string (`'#FF5733'`), a palette name (`'blues'`, see {@link colorPaletteIDs}), or a MapLibre expression
-   * for data-driven styling (e.g. `['get', 'color']`).
+   * Fill color: a CSS colour string (`'#FF5733'`) or a MapLibre expression for data-driven styling
+   * (e.g. `['get', 'color']`).
    *
    * @remarks
-   * Overrides the top-level {@link GeometriesModuleConfig.color} for the fill, and for the border
-   * unless {@link GeometryLineConfig.color | line.color} is set. A feature's own `color` property
-   * overrides it.
+   * Overrides {@link GeometryFillConfig.palette | palette} and the top-level
+   * {@link GeometriesModuleConfig.color}, for the fill and the border; the full order is on the latter.
    */
-  color?: ColorPaletteOptions | string | ExpressionSpecification;
+  color?: string | ExpressionSpecification;
+  /**
+   * Named palette the features take their fill colours from, one per feature in turn
+   * (see {@link colorPaletteIDs}). On dark map styles its colours are adapted to stay legible.
+   *
+   * @remarks
+   * Overrides the top-level {@link GeometriesModuleConfig.color}, for the fill and the border; the
+   * full order is on the latter.
+   */
+  palette?: ColorPaletteOptions;
   /**
    * Fill opacity, 0 (transparent) to 1 (opaque). Also accepts a MapLibre expression.
    *
@@ -6495,34 +6791,36 @@ export type GeometryFillConfig = {
  * The label drawn at the center of each geometry: its text, and how it looks.
  *
  * @remarks
- * Unset styling fields keep the defaults: size 15, bold font, and theme-adaptive colours —
- * `'#333333'` text with a `'#FFFFFF'` halo on light map styles, the reverse on dark.
+ * Unset fields keep the defaults: the feature's `title` as text, size 15, bold font, and
+ * theme-adaptive colours — `'#333333'` text with a `'#FFFFFF'` halo on light map styles, the
+ * reverse on dark.
  *
  * @example
  * ```typescript
  * // Simple text
- * const label: GeometryLabel = {
+ * const label: GeometryLabelConfig = {
  *   text: ['get', 'name']
  * };
  *
  * // Conditional text, larger and in white
- * const conditionalLabel: GeometryLabel = {
+ * const conditionalLabel: GeometryLabelConfig = {
  *   text: ['case', ['has', 'title'], ['get', 'title'], ['get', 'id']],
  *   size: 18,
  *   color: '#FFFFFF',
  *   haloColor: '#000000',
  * };
+ *
+ * // The title, restyled
+ * const largeLabel: GeometryLabelConfig = { size: 18 };
  * ```
  *
  * @group Geometries
  */
-export type GeometryLabel = LabelConfig & {
+export type GeometryLabelConfig = LabelConfig & {
   /**
-   * Text content to display as label.
+   * Text of the label: a string, or a MapLibre expression that evaluates to one.
    *
-   * @remarks
-   * Must be a MapLibre expression that evaluates to a string.
-   * Labels are positioned at the geometry's center point.
+   * @default ['get', 'title']
    *
    * @example
    * ```typescript
@@ -6536,7 +6834,7 @@ export type GeometryLabel = LabelConfig & {
    * text: ['case', ['has', 'label'], ['get', 'label'], '']
    * ```
    */
-  text: DataDrivenPropertyValueSpecification<string>;
+  text?: DataDrivenPropertyValueSpecification<string>;
 };
 /**
  * Line/border configuration for geometries — the outline color, opacity, width, an escape hatch for
@@ -6567,8 +6865,9 @@ export type GeometryLineConfig = {
    * Border/outline color: a hex string or a MapLibre expression (e.g. `['get', 'borderColor']`).
    *
    * @remarks
-   * Overrides a feature's `color` property, {@link GeometryFillConfig.color | fill.color} and the
-   * top-level {@link GeometriesModuleConfig.color} for the border.
+   * Overrides a feature's `color` property, {@link GeometryFillConfig.color | fill.color},
+   * {@link GeometryFillConfig.palette | fill.palette} and the top-level
+   * {@link GeometriesModuleConfig.color} for the border.
    */
   color?: DataDrivenPropertyValueSpecification<string>;
   /**
@@ -6607,23 +6906,26 @@ export type GeometryLineConfig = {
   layer?: Partial<ToBeAddedLayerSpecTemplate<LineLayerSpecification>>;
 };
 /**
- * Labels placed along the polygon border lines, repeating the geometry's title.
+ * Labels placed along the polygon border lines: the center label's fields, plus where along the
+ * border they repeat.
  *
  * When set, a symbol layer is added to the geometry source.
  *
  * @remarks
  * Defaults for the unset fields:
- * - `minZoom` 3, `size` 15, `haloWidth` 2, `symbolSpacing` 200, `opacity` 1, `offset` `[0, 1]`, bold font.
+ * - `text` the feature's `title`, `minZoom` 3, `size` 15, `haloWidth` 2, `symbolSpacing` 200,
+ *   `opacity` 1, `offset` `[0, 1]`, bold font.
  * - `color` and `haloColor` are theme-adaptive: `'#333333'` text with a `'#FFFFFF'` halo on light map
  *   styles, the reverse on dark.
  *
  * @example
  * ```typescript
  * // Defaults
- * const lineLabel: GeometryLineLabel = {};
+ * const lineLabel: GeometryLineLabelConfig = {};
  *
- * // Custom appearance for dark fills
- * const lineLabel: GeometryLineLabel = {
+ * // Custom text and appearance for dark fills
+ * const lineLabel: GeometryLineLabelConfig = {
+ *   text: ['get', 'name'],
  *   minZoom: 10,
  *   color: '#FFFFFF',
  *   haloColor: '#000000',
@@ -6633,7 +6935,7 @@ export type GeometryLineConfig = {
  *
  * @group Geometries
  */
-export type GeometryLineLabel = LabelConfig & {
+export type GeometryLineLabelConfig = GeometryLabelConfig & {
   /**
    * Minimum zoom level at which border labels are visible.
    *
@@ -6728,6 +7030,8 @@ export type GeometryBeforeLayerConfig = PartsBeforeLayerConfig<'fill' | 'line'>;
  * };
  * ```
  *
+ * @see {@link GeometriesModuleSerializableConfig} for the part that survives JSON.
+ *
  * @group Geometries
  */
 export type GeometriesModuleConfig = MapModuleCommonConfig & {
@@ -6736,9 +7040,10 @@ export type GeometriesModuleConfig = MapModuleCommonConfig & {
    *
    * @remarks
    * Precedence, highest first:
-   * - Fill: a feature's own `color` property, {@link GeometryFillConfig.color | fill.color}, this field.
+   * - Fill: a feature's own `color` property, {@link GeometryFillConfig.color | fill.color},
+   *   {@link GeometryFillConfig.palette | fill.palette}, this field.
    * - Border: {@link GeometryLineConfig.color | line.color}, a feature's own `color` property, `fill.color`,
-   *   this field.
+   *   `fill.palette`, this field.
    * - Then, for both: the map's accent when a theme sets one ({@link TomTomMap.mapColors}), else a
    *   theme-adaptive default — `'#0A3653'` on light map styles, `'#5FA8D8'` on dark (custom styles count as light).
    *
@@ -6765,7 +7070,7 @@ export type GeometriesModuleConfig = MapModuleCommonConfig & {
   /**
    * The label at each geometry's center: its text and styling.
    */
-  label?: GeometryLabel;
+  label?: GeometryLabelConfig;
   /**
    * Border/outline configuration.
    *
@@ -6794,7 +7099,7 @@ export type GeometriesModuleConfig = MapModuleCommonConfig & {
   /**
    * Labels along the polygon border lines, drawn only when this is set (`{}` for the defaults).
    */
-  lineLabel?: GeometryLineLabel;
+  lineLabel?: GeometryLineLabelConfig;
   /**
    * How every feature shown by this module is filled.
    *
@@ -6843,6 +7148,24 @@ export type GeometriesModuleConfig = MapModuleCommonConfig & {
    */
   transformFeaturesForDisplay?: (input: PolygonFeatures) => PolygonFeatures;
 };
+/**
+ * The part of a {@link GeometriesModuleConfig} that survives JSON, for saving
+ * `getConfig()` and replaying it with `applyConfig()`.
+ *
+ * @remarks
+ * It leaves out `transformFeaturesForDisplay`, a function, which a replay adds back in code.
+ *
+ * @example
+ * ```typescript
+ * const saved = JSON.stringify(geometries.getConfig());
+ *
+ * const state: GeometriesModuleSerializableConfig = JSON.parse(saved);
+ * geometries.applyConfig({ ...state, transformFeaturesForDisplay: addAreaLabels });
+ * ```
+ *
+ * @group Geometries
+ */
+export type GeometriesModuleSerializableConfig = Omit<GeometriesModuleConfig, 'transformFeaturesForDisplay'>;
 //#endregion
 //#region src/geometry/GeometriesModule.d.ts
 /**
@@ -7051,7 +7374,8 @@ export declare class GeometriesModule extends AbstractDataOwnedMapModule<Geometr
    * @ignore
    */
   protected _applyConfig(config: GeometriesModuleConfig | undefined): GeometriesModuleConfig | undefined;
-  private applyVisibility;
+  /** @ignore */
+  protected applyVisibility(config: GeometriesModuleConfig | undefined): void;
   private get partLayerIDs();
   /**
    * Positions the geometry layers relative to other map layers.
@@ -7072,26 +7396,6 @@ export declare class GeometriesModule extends AbstractDataOwnedMapModule<Geometr
    * ```
    */
   moveBeforeLayer(layerConfig: GeometryBeforeLayerConfig): void;
-  /**
-   * Shows or hides everything the module draws: fills, borders, center labels and border labels.
-   *
-   * @remarks
-   * `show()` and `clear()` never change it: a hidden module keeps its data and draws it again on
-   * `setVisible(true)`.
-   *
-   * @example
-   * ```typescript
-   * geometries.setVisible(false);
-   * await geometries.show(areas); // stays hidden
-   * geometries.setVisible(true);
-   * ```
-   */
-  setVisible(visible: boolean): void;
-  /**
-   * Whether the module is set to be shown ({@link GeometriesModuleConfig.visible}). A shown module
-   * with no geometries draws nothing.
-   */
-  isVisible(): boolean;
   private applyBeforeLayerConfig;
   /**
    * Updates the label at the center of each displayed geometry: its text and styling.
@@ -7100,19 +7404,19 @@ export declare class GeometriesModule extends AbstractDataOwnedMapModule<Geometr
    *
    * @remarks
    * **Configuration:**
-   * - `text`: MapLibre expression for label text content
+   * - `text`: label text, a string or a MapLibre expression; the feature's `title` when unset
    * - `size`, `color`, `haloColor`, `haloWidth`, `opacity`, `font`: label styling
    * - Changes apply to currently shown and future geometries
    *
    * @example
    * ```typescript
    * // Show feature property as label
-   * geometries.applyTextConfig({
+   * geometries.applyLabelConfig({
    *   text: ['get', 'name']
    * });
    *
    * // Conditional labels, in white
-   * geometries.applyTextConfig({
+   * geometries.applyLabelConfig({
    *   text: [
    *     'case',
    *     ['has', 'label'],
@@ -7123,16 +7427,14 @@ export declare class GeometriesModule extends AbstractDataOwnedMapModule<Geometr
    * });
    * ```
    */
-  applyTextConfig(label: GeometryLabel): void;
-  private updateLayerAndData;
+  applyLabelConfig(label: GeometryLabelConfig): void;
+  private updateLayers;
   /**
    * @ignore
    */
   protected discardShownData(): void;
-  /**
-   * @ignore
-   */
-  protected restoreDataAndConfigImpl(): void;
+  private prepare;
+  private display;
   /**
    * Displays the given polygon geometries on the map.
    *
@@ -7274,97 +7576,191 @@ export declare class GeometriesModule extends AbstractDataOwnedMapModule<Geometr
   get events(): GeometriesEvents;
 }
 //#endregion
-//#region src/geometry/prepareReachableRangesForDisplay.d.ts
-/** Custom label generator for reachable range features. */
-export type ReachableRangeLabelFn = (feature: PolygonFeature, index: number) => string;
+//#region src/geometry/types/geometryConfigOptions.d.ts
 /**
- * Attaches labels and applies fill-style-specific geometry to reachable range polygon features.
- *
- * Features must be ordered **largest budget first** (e.g. 30 min, 20 min, 10 min).
- * For the `inverted` fill style, polygons are converted to donuts and one extra innermost feature is appended.
- *
- * @param features  Polygon features from `calculateReachableRange`, ordered largest budget first.
- * @param labels    Label per feature in matching order (e.g. `['30 min', '20 min', '10 min']`).
- * @param fillStyle Fill style. Defaults to `'filled'`.
- *
- * @example
- * ```typescript
- * const features = [range30min, range20min, range10min];
- * const labels   = ['30 min', '20 min', '10 min'];
- *
- * module.show({
- *     type: 'FeatureCollection',
- *     features: buildReachableRangeFeatures(features, labels, 'inverted'),
- * });
- * ```
+ * Custom title generator for reachable range features: the text of each range's labels.
  *
  * @group Geometries
  */
-export declare const buildReachableRangeFeatures: (features: PolygonFeature[], labels: string[], fillStyle?: GeometryFillStyle) => PolygonFeature[];
+export type ReachableRangeTitleFn = (feature: PolygonFeature, index: number) => string;
 /**
- * Prepares the output of `calculateReachableRanges` for display with {@link GeometriesModule}.
- *
- * Derives labels from each feature's `budget` property by default, applies fill-style-specific
- * geometry, and preserves the bounding box. Pass the returned value directly to `module.show()`.
- *
- * Note: when using {@link reachableRangeGeometryConfig} this is called automatically — you only
- * need this function for explicit control over labels or fill style.
- *
- * Features must be ordered **largest budget first** (e.g. 30 min, 20 min, 10 min).
- *
- * @param result Raw output of `calculateReachableRanges`.
- * @param fillStyle Fill style. Defaults to `'filled'`.
- * @param label Custom label generator; when omitted, labels derived from `budget` property.
- *
- * @example
- * ```typescript
- * // explicit control:
- * module.show(prepareReachableRangesForDisplay(result, 'inverted'));
- * module.show(prepareReachableRangesForDisplay(result, 'filled', (f) => myLabel(f)));
- * ```
+ * Options of {@link prepareReachableRangesForDisplay}.
  *
  * @group Geometries
  */
-export declare const prepareReachableRangesForDisplay: (result: PolygonFeatures, fillStyle?: GeometryFillStyle, label?: ReachableRangeLabelFn) => PolygonFeatures;
-//#endregion
-//#region src/geometry/geometryConfigs.d.ts
+export type ReachableRangesDisplayOptions = {
+  /**
+   * How each range is filled.
+   *
+   * @default 'filled'
+   */
+  fillStyle?: GeometryFillStyle;
+  /**
+   * Each range's title, shown by its labels. Unset, it is the feature's `budget`, e.g. `'30 min'`.
+   */
+  title?: ReachableRangeTitleFn;
+};
 /**
- * Config that draws each polygon by its own fill style, with palette-based coloring.
- *
- * Includes data-driven expressions so each feature's `fillStyle` property controls its
- * styling, line labels config, and positions layers below map labels.
- *
- * For reachable ranges, use {@link reachableRangeGeometryConfig} which extends this
- * with auto-generated labels.
- *
- * @param palette Color palette for polygon fills. Defaults to `'fadedRainbow'`.
- * @param beforeLayerConfig Layer positioning. Defaults to `'lowestLabel'`.
+ * Options of {@link fillStyledGeometryConfig}.
  *
  * @group Geometries
  */
-export declare const fillStyledGeometryConfig: (palette?: ColorPaletteOptions, beforeLayerConfig?: GeometryBeforeLayerConfig) => GeometriesModuleConfig;
+export type FillStyledGeometryConfigOptions = {
+  /**
+   * Color palette for polygon fills.
+   *
+   * @default 'fadedRainbow'
+   */
+  palette?: ColorPaletteOptions;
+  /**
+   * Layer positioning.
+   *
+   * @default 'lowestLabel'
+   */
+  beforeLayerConfig?: GeometryBeforeLayerConfig;
+};
+/**
+ * Options of {@link reachableRangeGeometryConfig}: the palette and positioning of
+ * {@link fillStyledGeometryConfig}, and how {@link prepareReachableRangesForDisplay} fills and titles
+ * each range.
+ *
+ * @group Geometries
+ */
+export type ReachableRangeGeometryConfigOptions = FillStyledGeometryConfigOptions & ReachableRangesDisplayOptions;
+//#endregion
+//#region src/geometry/geometryConfigs.d.ts
+/**
+ * Config that draws each polygon by its own fill style, with palette-based coloring.
+ *
+ * Includes data-driven expressions so each feature's `fillStyle` property controls its
+ * styling, line labels config, and positions layers below map labels.
+ *
+ * For reachable ranges, use {@link reachableRangeGeometryConfig} which extends this
+ * with auto-generated labels.
+ *
+ * @example
+ * ```typescript
+ * const zones = await GeometriesModule.create(map, fillStyledGeometryConfig({ palette: 'retro' }));
+ * ```
+ *
+ * @group Geometries
+ */
+export declare const fillStyledGeometryConfig: ({ palette, beforeLayerConfig }?: FillStyledGeometryConfigOptions) => GeometriesModuleConfig;
 /**
  * Returns a {@link GeometriesModuleConfig} for reachable ranges.
  *
  * Builds on {@link fillStyledGeometryConfig} and overrides `transformFeaturesForDisplay` so the
  * raw output of `calculateReachableRanges` can be passed directly to {@link GeometriesModule.show}
- * — labels are derived from each feature's `budget` property.
- *
- * @param palette Color palette. Defaults to `'fadedRainbow'`.
- * @param fillStyle Fill style. Defaults to `'filled'`.
- * @param beforeLayerConfig Layer positioning. Defaults to `'lowestLabel'`.
- * @param label Custom label generator; when omitted, labels are derived from `budget` property.
+ * — titles are derived from each feature's `budget` property.
  *
  * @example
  * ```typescript
  * const module = await GeometriesModule.create(map, reachableRangeGeometryConfig());
  * const result = await calculateReachableRanges([...]);
- * module.show(result); // labels and fill style applied automatically
+ * module.show(result); // titles and fill style applied automatically
+ *
+ * module.applyConfig(reachableRangeGeometryConfig({ palette: 'cold', fillStyle: 'inverted' }));
+ * ```
+ *
+ * @group Geometries
+ */
+export declare const reachableRangeGeometryConfig: ({ palette, beforeLayerConfig, fillStyle, title }?: ReachableRangeGeometryConfigOptions) => GeometriesModuleConfig;
+//#endregion
+//#region src/geometry/types/geometriesKnobs.d.ts
+/**
+ * The id of a geometries knob: its path into {@link GeometriesModuleConfig}, e.g. `fill.opacity` or
+ * `lineLabel.minZoom`. See {@link geometriesKnobCatalogue} for what each one does.
+ *
+ * @group Geometries
+ */
+type GeometriesKnobId = 'color' | 'visible' | 'fillStyle' | `fill.${keyof GeometryFillConfig}` | `line.${Exclude<keyof GeometryLineConfig, 'layer'>}` | `label.${Exclude<keyof GeometryLabelConfig, 'text'>}` | `lineLabel.${Exclude<keyof GeometryLineLabelConfig, 'text'>}`;
+/**
+ * The value type a given geometries knob takes: the plain value its path holds in
+ * {@link GeometriesModuleConfig}. The MapLibre expressions the config also takes there are not knob
+ * values.
+ *
+ * @group Geometries
+ */
+type GeometriesKnobValueOf<ID extends GeometriesKnobId> = KnobPlainValue<ValueAt<GeometriesModuleConfig, ID>>;
+/**
+ * One entry of {@link geometriesKnobCatalogue}. The value in force is the one at its path in
+ * {@link GeometriesModule.getConfig}, else its `default`; with neither, the map style, the accent
+ * or the fill style decides.
+ *
+ * @group Geometries
+ */
+type GeometriesKnob = KnobEntry<GeometriesKnobId, Exclude<KnobKind, 'colors'>>;
+//#endregion
+//#region src/geometry/knobCatalogue.d.ts
+/**
+ * Every geometries knob with its kind, description, range or options and, where one value holds
+ * everywhere, its default: the module-wide knobs, the fill and border, then the center and border
+ * labels. Static data, readable with no map loaded.
+ *
+ * @remarks
+ * A knob is a plain display value in {@link GeometriesModuleConfig}, at the path its id names. Not
+ * knobs: `beforeLayerConfig`, `line.layer`, the labels' `text` and `transformFeaturesForDisplay`,
+ * which take structured, MapLibre or function values; and `events`.
+ * Setting any `lineLabel` knob draws the border labels.
+ *
+ * @group Geometries
+ */
+export declare const geometriesKnobCatalogue: readonly GeometriesKnob[];
+/**
+ * Every geometries knob id, in catalogue order.
+ *
+ * @group Geometries
+ */
+export declare const geometriesKnobIds: readonly GeometriesKnobId[];
+//#endregion
+//#region src/geometry/prepareReachableRangesForDisplay.d.ts
+/**
+ * Attaches labels and applies fill-style-specific geometry to reachable range polygon features.
+ *
+ * Features must be ordered **largest budget first** (e.g. 30 min, 20 min, 10 min).
+ * For the `inverted` fill style, polygons are converted to donuts and one extra innermost feature is appended.
+ *
+ * @param features  Polygon features from `calculateReachableRange`, ordered largest budget first.
+ * @param labels    Label per feature in matching order (e.g. `['30 min', '20 min', '10 min']`).
+ * @param fillStyle Fill style. Defaults to `'filled'`.
+ *
+ * @example
+ * ```typescript
+ * const features = [range30min, range20min, range10min];
+ * const labels   = ['30 min', '20 min', '10 min'];
+ *
+ * module.show({
+ *     type: 'FeatureCollection',
+ *     features: buildReachableRangeFeatures(features, labels, 'inverted'),
+ * });
+ * ```
+ *
+ * @group Geometries
+ */
+export declare const buildReachableRangeFeatures: (features: PolygonFeature[], labels: string[], fillStyle?: GeometryFillStyle) => PolygonFeature[];
+/**
+ * Prepares the output of `calculateReachableRanges` for display with {@link GeometriesModule}.
+ *
+ * Derives titles from each feature's `budget` property by default, applies fill-style-specific
+ * geometry, and preserves the bounding box. Pass the returned value directly to `module.show()`.
+ *
+ * Note: when using {@link reachableRangeGeometryConfig} this is called automatically — you only
+ * need this function for explicit control over titles or fill style.
+ *
+ * Features must be ordered **largest budget first** (e.g. 30 min, 20 min, 10 min).
+ *
+ * @param result Raw output of `calculateReachableRanges`.
+ *
+ * @example
+ * ```typescript
+ * // explicit control:
+ * module.show(prepareReachableRangesForDisplay(result, { fillStyle: 'inverted' }));
+ * module.show(prepareReachableRangesForDisplay(result, { title: (feature) => myTitle(feature) }));
  * ```
  *
  * @group Geometries
  */
-export declare const reachableRangeGeometryConfig: (palette?: ColorPaletteOptions, fillStyle?: GeometryFillStyle, beforeLayerConfig?: GeometryBeforeLayerConfig, label?: ReachableRangeLabelFn) => GeometriesModuleConfig;
+export declare const prepareReachableRangesForDisplay: (result: PolygonFeatures, { fillStyle, title }?: ReachableRangesDisplayOptions) => PolygonFeatures;
 //#endregion
 //#region src/geometry/types/geometryDisplayProps.d.ts
 /**
@@ -7529,322 +7925,130 @@ export declare const baseMapPOICategoryValues: readonly string[];
  */
 export declare const toBaseMapPOIGroup: (category: POICategory) => string | undefined;
 //#endregion
-//#region src/places/types/placeDisplayProps.d.ts
+//#region src/places/types/placesModuleConfig.d.ts
 /**
- * Properties attached to a place feature for rendering on the map.
+ * The kind of marker places are drawn with.
  *
  * @remarks
- * Extends the source place with display-only fields consumed by the places
- * layer stack. Which fields are populated depends on the active
- * {@link PlacesTheme | theme}:
+ * - `pin`: Traditional map pin markers (teardrop shape)
+ * - `circle-icon`: Simple circular markers
+ * - `base-map`: Mimics the map's built-in POI layer style with category icons (combines `main`, `selected`, and `micro` layers). For micro-only rendering, hide the `main` layer via `layers.main.layout.visibility = 'none'`.
+ * - `pin-clustered`: Same teardrop pins as `pin` for un-clustered places, with nearby
+ *   places aggregated into a single icon. Single-category clusters render the matching
+ *   base-map POI sprite with a small count badge in the top-right; mixed-category
+ *   clusters render a larger centred count circle in place of the icon. Cluster features
+ *   expose `clusterBaseMapIconIDs` (comma-separated, deduplicated) on their properties.
+ *   {@link PlacesModuleConfig.cluster} configures both.
  *
- * - Every theme uses {@link PlaceDisplayProps.iconID | iconID} — the sprite name
- *   the main layer's `icon-image` expression binds to via `['get', 'iconID']`.
- *   The base map's POI-Micro-like layer inherits the style's `['get','group']`
- *   expression verbatim, so custom `PlaceIconConfig.categoryIcons` sprites only
- *   apply to the `main` layer.
- * - The `base-map` theme additionally populates
- *   {@link PlaceDisplayProps.category | category} and
- *   {@link PlaceDisplayProps.group | group} so the base map style's own
- *   `text-color` expression — and the POI-Micro layer's `icon-image` expression
- *   — resolve against the place feature just as they do for native POIs.
+ * @group Places
+ */
+type PlacesMarkerType = (typeof placesMarkerTypes)[number];
+/**
+ * All valid {@link PlacesMarkerType} values.
+ *
+ * @group Places
+ */
+export declare const placesMarkerTypes: readonly ["pin", "circle-icon", "base-map", "pin-clustered"];
+/**
+ * Configuration for EV charging station availability display.
+ *
+ * @remarks
+ * **Opt-In Feature:**
+ * - Disabled by default - set `enabled: true` to activate
+ * - Requires fetching availability via {@link getPlacesWithEVAvailability}
+ * - Each PlacesModule can enable/disable independently
+ *
+ * When enabled, displays formatted availability text (e.g., "3/10") below the station name
+ * with color-coding based on availability ratio: green (high), orange (limited), red (none/low).
  *
  * @example
  * ```typescript
- * const pinPlaceProps: PlaceDisplayProps = {
- *   id: 'place-123',
- *   title: 'Central Station',
- *   iconID: 'poi-transit',
- * };
+ * // Enable with defaults
+ * const places = await PlacesModule.create(map, {
+ *   evAvailability: { enabled: true }
+ * });
+ * const stations = await discoverPlaces({ filters: { poiCategories: ['CHARGING_LOCATION'] } });
+ * places.show(await getPlacesWithEVAvailability(stations));
  *
- * const baseMapPlaceProps: PlaceDisplayProps = {
- *   id: 'place-123',
- *   title: 'Central Station',
- *   iconID: 'poi-railway_station',
- *   category: 'railway_station',
- *   group: 'transport',
- * };
+ * // Custom threshold and format
+ * const places = await PlacesModule.create(map, {
+ *   evAvailability: {
+ *     enabled: true,
+ *     threshold: 0.5,
+ *     formatText: (available, total) => `${available} of ${total}`
+ *   }
+ * });
+ *
+ * // Combine with custom icon
+ * const places = await PlacesModule.create(map, {
+ *   icon: {
+ *     categoryIcons: [{
+ *       id: 'CHARGING_LOCATION',
+ *       image: customEvIconSvg,
+ *       pixelRatio: 2
+ *     }]
+ *   },
+ *   evAvailability: { enabled: true }
+ * });
  * ```
  *
  * @group Places
  */
-export type PlaceDisplayProps = {
+type EVAvailabilityConfig = {
   /**
-   * Unique identifier for the place feature.
+   * Enable or disable EV availability display.
    *
    * @remarks
-   * MapLibre does not reuse the feature IDs, so we either generate one on the
-   * fly or promote the one from `properties.id` via the source's `promoteId`
-   * option. Used for feature identification in events, hit-testing, and data
-   * updates.
-   *
-   * @example
-   * ```typescript
-   * id: 'place-123'
-   * ```
+   * Must be explicitly set to `true` to display availability.
    */
-  id: string;
+  enabled?: boolean;
   /**
-   * Text label rendered next to the place marker.
+   * Availability ratio threshold for determining available vs occupied.
    *
    * @remarks
-   * Optional — when absent no label is drawn. Typically sourced from the POI
-   * name or free-form address, but can be any custom string (e.g., configured
-   * via `PlacesModuleConfig.text.title`).
+   * - `ratio >= threshold`: Available (green)
+   * - `ratio < threshold`: Occupied (red)
    *
-   * @example
-   * ```typescript
-   * title: 'Amsterdam Central Station'
-   * ```
+   * @default 0.3
    */
-  title?: string;
+  threshold?: number;
   /**
-   * Sprite image ID used to draw the place marker.
+   * Custom function to format the availability text.
    *
-   * @remarks
-   * The main layer binds `icon-image` to `['get', 'iconID']`, so the sprite
-   * named here is what renders. The base map's POI-Micro-like layer inherits
-   * the style's group-driven expression verbatim and ignores this value. The
-   * sprite name is resolved per theme: `pin` picks a POI category image of the
-   * `pinCategories` sprite, so its ID carries that sprite's namespace;
-   * `circle-icon` and `base-map` pick the base map's `poi-<category>` image; a
-   * custom `PlaceIconConfig.categoryIcons` entry overrides the default for the
-   * main layer on any theme.
+   * @param available - Number of available charging points
+   * @param total - Total number of charging points
+   * @returns Formatted availability text
    *
-   * @example
-   * ```typescript
-   * iconID: 'pinCategories:7315' // pin theme sprite
-   * iconID: 'poi-restaurant'     // circle-icon / base-map theme sprite
-   * iconID: 'custom-marker-0'    // user-provided custom icon
-   * ```
+   * @default (available, total) => `${available}/${total}`
    */
-  iconID: string;
+  formatText?: (available: number, total: number) => string;
+};
+/**
+ * Configuration for the default place icon.
+ * * This is the icon that is used for clicked locations and addresses without a specific category.
+ *
+ * @group Places
+ */
+type DefaultPlaceIconConfig = {
   /**
-   * Base map style POI category the place should be rendered as.
+   * Base style options for the SVG default icon.
    *
    * @remarks
-   * Populated only for the `base-map` theme. Values are the lowercased
-   * identifiers used by the base map style (derived via
-   * {@link toBaseMapPOICategory}). Drives the inherited `text-color`
-   * expression on the main/selected POI-like layers.
+   * Use this to set the fill color, outline color, and outline opacity for the default waypoint icon.
+   * Without a `fillColor`, the pin takes {@link PlacesModuleConfig.color}.
    *
-   * @example
+   * Example:
    * ```typescript
-   * category: 'restaurant'
-   * category: 'hotel_or_motel'
-   * category: 'charging_location'
+   * baseStyle: {
+   *   fillColor: '#007AFF',
+   *   outlineColor: '#FFFFFF',
+   *   outlineOpacity: 0.8
+   * }
    * ```
    */
-  category?: string;
+  style?: SVGIconStyleOptions;
   /**
-   * Base map style POI group the place belongs to.
-   *
-   * @remarks
-   * Populated only for the `base-map` theme. Drives the inherited
-   * `text-color` expression on the base map's POI layers.
-   * Valid values are those produced by {@link toBaseMapPOIGroup} — e.g.,
-   * `eat_and_drink`, `lodging`, `driving`, `transport`, `shopping`,
-   * `healthcare`, `finance`, `cultural`, `leisure`, `sport`, `outdoor`,
-   * `protected`, `public`, `religion`, `military`, `business`, `education`,
-   * `parking`.
-   */
-  group?: string;
-} & SupportsEvents & Anything;
-/**
- * Full property shape used by the PlacesModule when rendering a place: the
- * core place data ({@link CommonPlaceProps}) merged with the display-only
- * fields the module attaches ({@link PlaceDisplayProps}).
- *
- * @example
- * ```typescript
- * const place: DisplayPlaceProps = {
- *   type: 'POI',
- *   poi: {
- *     name: 'Central Station',
- *     categories: ['RAILWAY_STATION'],
- *   },
- *   address: {
- *     streetName: 'Damrak',
- *     municipalitySubdivision: 'Amsterdam',
- *     countryCode: 'NL',
- *   },
- *   id: 'place-123',
- *   title: 'Amsterdam Central Station',
- *   iconID: 'poi-railway_station',
- *   category: 'railway_station',
- *   group: 'transport',
- * };
- * ```
- *
- * @group Places
- */
-export type DisplayPlaceProps = CommonPlaceProps & PlaceDisplayProps;
-//#endregion
-//#region src/places/types/entryPointDisplay.d.ts
-/**
- * Properties of an entry point drawn by {@link PlacesModule}: the {@link EntryPoint} itself, whose
- * position is the feature geometry, plus where it came from.
- *
- * @group Places
- */
-type PlaceEntryPointProps = Omit<EntryPoint, 'position'> & {
-  /**
-   * Unique identifier of the entry point feature, derived from its place.
-   */
-  id: string;
-  /**
-   * `id` of the place the entry point belongs to, as shown by the module.
-   */
-  placeID: string;
-  /**
-   * Index of the entry point in the `entryPoints` of its place.
-   */
-  entryPointIndex: number;
-} & SupportsEvents;
-/**
- * What `places.events.entryPoints` handlers receive: the entry point as a point feature, whether its
- * circle or its line was hit, together with the place it belongs to.
- *
- * @remarks
- * The place is passed as shown, with its own geometry. To route to the entrance, pass this feature
- * as the route location.
- *
- * @group Places
- */
-type PlaceEntryPointFeature = Feature<Point, PlaceEntryPointProps & {
-  /**
-   * The place the entry point belongs to. Absent only when that place left the map while the
-   * event was being handled.
-   */
-  place?: Place<DisplayPlaceProps>;
-}>;
-//#endregion
-//#region src/places/types/placesModuleConfig.d.ts
-/**
- * Icon style options for displaying places on the map.
- *
- * @remarks
- * **Available Styles:**
- * - `pin`: Traditional map pin markers (teardrop shape)
- * - `circle-icon`: Simple circular markers (previously named `circle`)
- * - `base-map`: Mimics the map's built-in POI layer style with category icons (combines `main`, `selected`, and `micro` layers). For micro-only rendering, hide the `main` layer via `layers.main.layout.visibility = 'none'`.
- * - `pin-clustered`: Same teardrop pins as `pin` for un-clustered places, with nearby
- *   places aggregated into a single icon. Single-category clusters render the matching
- *   base-map POI sprite with a small count badge in the top-right; mixed-category
- *   clusters render a larger centred count circle in place of the icon. Cluster features
- *   expose `clusterBaseMapIconIDs` (comma-separated, deduplicated) on their properties.
- *   {@link PlacesModuleConfig.cluster} configures both.
- *
- * @group Places
- */
-type PlacesTheme = (typeof placesThemes)[number];
-/**
- * All valid {@link PlacesTheme} values.
- *
- * @group Places
- */
-export declare const placesThemes: readonly ["pin", "circle-icon", "base-map", "pin-clustered"];
-/**
- * Configuration for EV charging station availability display.
- *
- * @remarks
- * **Opt-In Feature:**
- * - Disabled by default - set `enabled: true` to activate
- * - Requires fetching availability via {@link getPlacesWithEVAvailability}
- * - Each PlacesModule can enable/disable independently
- *
- * When enabled, displays formatted availability text (e.g., "3/10") below the station name
- * with color-coding based on availability ratio: green (high), orange (limited), red (none/low).
- *
- * @example
- * ```typescript
- * // Enable with defaults
- * const places = await PlacesModule.create(map, {
- *   evAvailability: { enabled: true }
- * });
- * const stations = await discoverPlaces({ filters: { poiCategories: ['CHARGING_LOCATION'] } });
- * places.show(await getPlacesWithEVAvailability(stations));
- *
- * // Custom threshold and format
- * const places = await PlacesModule.create(map, {
- *   evAvailability: {
- *     enabled: true,
- *     threshold: 0.5,
- *     formatText: (available, total) => `${available} of ${total}`
- *   }
- * });
- *
- * // Combine with custom icon
- * const places = await PlacesModule.create(map, {
- *   icon: {
- *     categoryIcons: [{
- *       id: 'CHARGING_LOCATION',
- *       image: customEvIconSvg,
- *       pixelRatio: 2
- *     }]
- *   },
- *   evAvailability: { enabled: true }
- * });
- * ```
- *
- * @group Places
- */
-type EVAvailabilityConfig = {
-  /**
-   * Enable or disable EV availability display.
-   *
-   * @remarks
-   * Must be explicitly set to `true` to display availability.
-   */
-  enabled?: boolean;
-  /**
-   * Availability ratio threshold for determining available vs occupied.
-   *
-   * @remarks
-   * - `ratio >= threshold`: Available (green)
-   * - `ratio < threshold`: Occupied (red)
-   *
-   * @default 0
-   */
-  threshold?: number;
-  /**
-   * Custom function to format the availability text.
-   *
-   * @param available - Number of available charging points
-   * @param total - Total number of charging points
-   * @returns Formatted availability text
-   *
-   * @default (available, total) => `${available}/${total}`
-   */
-  formatText?: (available: number, total: number) => string;
-};
-/**
- * Configuration for the default place icon.
- * * This is the icon that is used for clicked locations and addresses without a specific category.
- *
- * @group Places
- */
-type DefaultPlaceIconConfig = {
-  /**
-   * Base style options for the SVG default icon.
-   *
-   * @remarks
-   * Use this to set the fill color, outline color, and outline opacity for the default waypoint icon.
-   * Without a `fillColor`, the pin takes the map's accent colour when a theme sets one
-   * ({@link TomTomMap.mapColors}).
-   *
-   * Example:
-   * ```typescript
-   * baseStyle: {
-   *   fillColor: '#007AFF',
-   *   outlineColor: '#FFFFFF',
-   *   outlineOpacity: 0.8
-   * }
-   * ```
-   */
-  style?: SVGIconStyleOptions;
-  /**
-   * Custom image for the default icon.
+   * Custom image for the default icon.
    *
    * @remarks
    * If provided, this image will be used instead of the default icon, and `style` does not apply.
@@ -7861,15 +8065,15 @@ type DefaultPlaceIconConfig = {
  * // Custom icons for specific categories
  * const iconConfig: PlaceIconConfig = {
  *   categoryIcons: [
- *     { category: 'RESTAURANT', image: '/icons/food.png', pixelRatio: 2 },
- *     { category: 'HOTEL_OR_MOTEL', image: '/icons/hotel.png', pixelRatio: 2 }
+ *     { id: 'RESTAURANT', image: '/icons/food.png', pixelRatio: 2 },
+ *     { id: 'HOTEL_OR_MOTEL', image: '/icons/hotel.png', pixelRatio: 2 }
  *   ]
  * };
  * ```
  *
  * @group Places
  */
-type PlaceIconConfig = {
+type PlaceIconConfig<P extends CommonPlaceProps = CommonPlaceProps> = {
   /**
    * Configuration for the default place icon.
    * * The default icon is the one used for clicked locations and addresses without a specific category, or via custom mapping.
@@ -7894,6 +8098,9 @@ type PlaceIconConfig = {
    * - **`poiCategory`**: Returns a POI category, which is then resolved to an icon
    *   using the existing category-to-icon logic. This reuses the standard category mapping.
    *
+   * `fn` receives places of the shape the module was created for, so it reads your own
+   * properties typed.
+   *
    * @example
    * ```typescript
    * // Direct image ID mapping
@@ -7902,41 +8109,45 @@ type PlaceIconConfig = {
    *   fn: (place) => place.properties.poi?.name?.includes('urgent') ? 'urgent-icon' : 'default-icon'
    * }
    *
-   * // POI category mapping
-   * mapping: {
-   *   to: 'poiCategory',
-   *   fn: (place) => place.properties.customCategory || 'RESTAURANT'
-   * }
+   * // POI category mapping, from a property of your own
+   * type Venue = CommonPlaceProps & { venueCategory?: MapStylePOICategory };
+   * await PlacesModule.create<Venue>(map, {
+   *   icon: { mapping: { to: 'poiCategory', fn: (place) => place.properties.venueCategory ?? 'RESTAURANT' } },
+   * });
    * ```
    */
   mapping?: {
     to: 'imageID';
-    fn: (place: Place) => string;
+    fn: (place: Place<P>) => string;
   } | {
     to: 'poiCategory';
-    fn: (place: Place) => MapStylePOICategory;
+    fn: (place: Place<P>) => MapStylePOICategory;
   };
 };
 /**
- * Configuration for place text labels.
- *
- * Controls how text labels are displayed next to place markers, including
- * content, styling, and positioning.
+ * The content, look and position of the labels next to place markers.
  *
  * @remarks
- * All text properties support both functions (for dynamic values) and MapLibre
- * expressions (for data-driven styling).
+ * An unset {@link LabelConfig} field keeps the marker type's own label: under `base-map` the map
+ * style's POI labels; otherwise `#333333` text on a `#FFFFFF` halo (the reverse on a dark map),
+ * 14 to 16 pixels and a 1 to 1.5 pixel halo as the zoom grows, fully opaque. The label of a hovered
+ * or clicked place takes {@link PlacesModuleConfig.color} instead.
+ *
+ * Set labels here rather than with MapLibre's `setPaintProperty` / `setLayoutProperty` on the
+ * module's layers: a style change and a marker type change rebuild those layers from this config,
+ * dropping anything written on them directly. `title` as a function of the place has no MapLibre
+ * equivalent at all.
  *
  * @example
  * ```typescript
  * // Simple text from place name
- * const textConfig: PlaceTextConfig = {
- *   field: (place) => place.properties.poi?.name || place.properties.address.freeformAddress
+ * const label: PlaceLabelConfig = {
+ *   title: (place) => place.properties.poi?.name || place.properties.address.freeformAddress
  * };
  *
  * // Using MapLibre expression with styling
- * const textConfig: PlaceTextConfig = {
- *   field: ['get', 'title'],
+ * const styledLabel: PlaceLabelConfig = {
+ *   title: ['get', 'title'],
  *   size: 14,
  *   color: '#333',
  *   haloColor: '#fff',
@@ -7946,12 +8157,13 @@ type PlaceIconConfig = {
  *
  * @group Places
  */
-type PlaceTextConfig = {
+type PlaceLabelConfig<P extends CommonPlaceProps = CommonPlaceProps> = LabelConfig & {
   /**
    * Text content for the label.
    *
    * Can be a function that extracts text from the place properties (data-based),
-   * or a MapLibre expression for data-driven content (data-driven layer-based).
+   * or a MapLibre expression for data-driven content (data-driven layer-based). The function
+   * receives places of the shape the module was created for.
    *
    * @example
    * ```typescript
@@ -7967,66 +8179,7 @@ type PlaceTextConfig = {
    *
    * @see https://maplibre.org/maplibre-style-spec/types/#formatted
    */
-  title?: ((place: Place) => string) | DataDrivenPropertyValueSpecification<string>;
-  /**
-   * Font size in pixels.
-   *
-   * @default 12
-   *
-   * @example
-   * ```typescript
-   * size: 14
-   *
-   * // Data-driven size based on importance
-   * size: ['interpolate', ['linear'], ['get', 'priority'], 1, 16, 10, 10]
-   * ```
-   */
-  size?: DataDrivenPropertyValueSpecification<number>;
-  /**
-   * Text color.
-   *
-   * @default '#000000'
-   *
-   * @example
-   * ```typescript
-   * color: '#333333'
-   *
-   * // Category-based colors
-   * color: ['match', ['get', 'category'], 'RESTAURANT', '#D32F2F', '#1976D2']
-   * ```
-   */
-  color?: DataDrivenPropertyValueSpecification<string>;
-  /**
-   * Font face(s) to use for the text.
-   *
-   * @example
-   * ```typescript
-   * font: ['Open Sans Bold', 'Arial Unicode MS Bold']
-   * ```
-   */
-  font?: DataDrivenPropertyValueSpecification<Array<MapFont>>;
-  /**
-   * Text halo (outline) color for better readability.
-   *
-   * @default '#FFFFFF'
-   *
-   * @example
-   * ```typescript
-   * haloColor: '#fff'
-   * ```
-   */
-  haloColor?: DataDrivenPropertyValueSpecification<string>;
-  /**
-   * Text halo (outline) width in pixels.
-   *
-   * @default 1
-   *
-   * @example
-   * ```typescript
-   * haloWidth: 2  // Thicker outline for better contrast
-   * ```
-   */
-  haloWidth?: DataDrivenPropertyValueSpecification<number>;
+  title?: ((place: Place<P>) => string) | DataDrivenPropertyValueSpecification<string>;
   /**
    * Text offset from the icon in ems.
    *
@@ -8097,10 +8250,10 @@ type PlaceLayersConfig = {
    *
    * @remarks
    * Always registered and stacked below the `main` layer, but only renders features
-   * when the `base-map` theme is active — in that mode it mirrors the map style's
+   * under the `base-map` marker type — in that mode it mirrors the map style's
    * `POI - Micro` layer so place markers blend with the base map's lower-density
-   * POI rendering. For other themes the layer is hidden via
-   * `layout.visibility = 'none'` and acts as a no-op, making theme switches cheap
+   * POI rendering. For other marker types the layer is hidden via
+   * `layout.visibility = 'none'` and acts as a no-op, making marker type switches cheap
    * (no add/remove layer churn).
    */
   micro?: Partial<ToBeAddedLayerSpecTemplate<SymbolLayerSpecification>>;
@@ -8120,11 +8273,11 @@ type PlaceLayersConfig = {
    *
    * @remarks
    * Always registered and stacked above `selected`, but only renders under the
-   * `pin-clustered` theme and only for single-category clusters — every leaf in
+   * `pin-clustered` marker type and only for single-category clusters — every leaf in
    * the cluster shares the same base-map sprite, picked via a `match` over the
    * aggregated `clusterBaseMapIconIDs` property. Mixed-category clusters fall
    * through to {@link clusterMixedBadge} + {@link clusterMixedCount} instead.
-   * For other themes the layer is hidden via `layout.visibility = 'none'`.
+   * For other marker types the layer is hidden via `layout.visibility = 'none'`.
    */
   cluster?: Partial<ToBeAddedLayerSpecTemplate<SymbolLayerSpecification>>;
   /**
@@ -8133,7 +8286,7 @@ type PlaceLayersConfig = {
    * @remarks
    * Circle drawn at the top-right of each single-category cluster pin.
    * Acts as the background for {@link clusterCount}. Only visible under the
-   * `pin-clustered` theme and gated to single-category clusters; mixed
+   * `pin-clustered` marker type and gated to single-category clusters; mixed
    * clusters use {@link clusterMixedBadge} instead.
    */
   clusterBadge?: Partial<ToBeAddedLayerSpecTemplate<CircleLayerSpecification>>;
@@ -8143,13 +8296,13 @@ type PlaceLayersConfig = {
    * @remarks
    * Count rendered on top of {@link clusterBadge} for single-category
    * clusters. Reads the `point_count_abbreviated` property MapLibre sets on
-   * every cluster feature. Only visible under the `pin-clustered` theme;
+   * every cluster feature. Only visible under the `pin-clustered` marker type;
    * mixed clusters use {@link clusterMixedCount} instead.
    */
   clusterCount?: Partial<ToBeAddedLayerSpecTemplate<SymbolLayerSpecification>>;
   /**
    * Centred count badge for mixed-category clusters under the
-   * `pin-clustered` theme.
+   * `pin-clustered` marker type.
    *
    * @remarks
    * Replaces the cluster icon entirely when a cluster spans multiple POI
@@ -8182,6 +8335,10 @@ type PlaceLayerName = keyof PlaceLayersConfig;
  * id is given, the module resolves it against its currently shown places to obtain the
  * coordinates; connections referencing unknown ids are silently skipped.
  *
+ * An id resolves each time the connections are drawn — on `showConnections()`, a configuration
+ * change and a style change. `show()` and `clear()` drop every connection, so none outlives the
+ * places it referred to, and none comes back when those places are shown again.
+ *
  * Extra arbitrary properties are preserved on the connection and passed to the optional
  * label function, making it easy to render metadata such as distance or travel time
  * along the line.
@@ -8278,7 +8435,7 @@ type PlaceConnectionsConfig = {
   layers?: PlaceConnectionsLayersConfig;
 };
 /**
- * Appearance of the cluster count badge under the `pin-clustered` theme.
+ * Appearance of the cluster count badge under the `pin-clustered` marker type.
  *
  * @remarks
  * Each field applies to single-category and mixed-category clusters alike. The matching
@@ -8344,15 +8501,15 @@ type PlaceClusterBadgeConfig = {
   textSize?: DataDrivenPropertyValueSpecification<number>;
 };
 /**
- * Configuration for the `pin-clustered` theme.
+ * Configuration for the `pin-clustered` marker type.
  *
  * @remarks
- * Ignored by every other {@link PlacesTheme}.
+ * Ignored by every other {@link PlacesMarkerType}.
  *
  * @example
  * ```typescript
  * const places = await PlacesModule.create(map, {
- *   theme: 'pin-clustered',
+ *   markerType: 'pin-clustered',
  *   cluster: {
  *     badge: { color: '#3f9cd9', radius: { single: 13, mixed: 18 } }
  *   }
@@ -8371,14 +8528,14 @@ type PlacesClusterConfig = {
    *
    * @remarks
    * - Changing them with {@link PlacesModule.applyConfig} recreates the places source.
-   * - `cluster` itself is not settable: `theme: 'pin-clustered'` switches clustering on.
+   * - `cluster` itself is not settable: `markerType: 'pin-clustered'` switches clustering on.
    * - `clusterProperties` land on each cluster feature's properties, for layer overrides to read
    *   with `['get', '<key>']`. The key `clusterBaseMapIconIDs` is reserved for the module's own.
    *
    * @example
    * ```typescript
    * const places = await PlacesModule.create(map, {
-   *   theme: 'pin-clustered',
+   *   markerType: 'pin-clustered',
    *   cluster: {
    *     source: {
    *       clusterRadius: 100,
@@ -8472,7 +8629,7 @@ type PlaceEntryPointsConfig = {
    * Zoom level below which no entry point is drawn.
    *
    * @remarks
-   * Under the `pin-clustered` theme it is never lower than the first zoom without clusters:
+   * Under the `pin-clustered` marker type it is never lower than the first zoom without clusters:
    * `cluster.source.clusterMaxZoom` plus one, 18 by default.
    *
    * @default 15
@@ -8492,25 +8649,24 @@ type PlaceEntryPointsConfig = {
  * ```typescript
  * // Basic configuration
  * const config: PlacesModuleConfig = {
- *   icon: {
- *     style: 'pin'
- *   },
- *   text: {
- *     field: (place) => place.properties.poi?.name || 'Unknown',
+ *   markerType: 'pin',
+ *   color: '#E4572E',
+ *   label: {
+ *     title: (place) => place.properties.poi?.name || 'Unknown',
  *     size: 12
  *   }
  * };
  *
  * // Advanced configuration with custom properties
  * const config: PlacesModuleConfig = {
+ *   markerType: 'base-map',
  *   icon: {
- *     style: 'base-map',
  *     categoryIcons: [
- *       { category: 'RESTAURANT', image: '/icons/restaurant.png' }
+ *       { id: 'RESTAURANT', image: '/icons/restaurant.png' }
  *     ]
  *   },
- *   text: {
- *     field: ['get', 'title'],
+ *   label: {
+ *     title: ['get', 'title'],
  *     size: 14,
  *     color: '#333',
  *     haloColor: '#fff',
@@ -8523,54 +8679,62 @@ type PlaceEntryPointsConfig = {
  * };
  * ```
  *
+ * @see {@link PlacesModuleSerializableConfig} for the part that survives JSON.
+ *
  * @group Places
  */
 type PlacesModuleConfig<P extends CommonPlaceProps = CommonPlaceProps> = MapModuleCommonConfig & {
   /**
-   * Base style for all places.
+   * The kind of marker all places are drawn with.
    *
    * @remarks
-   * Can be overwritten by more advanced icon configurations.
+   * {@link PlaceIconConfig.categoryIcons} replace its icon for the categories they name, under
+   * every marker type.
    *
    * @default 'pin'
    */
-  theme?: PlacesTheme;
+  markerType?: PlacesMarkerType;
+  /**
+   * The colour of this module's own drawing: the default pin fill, the label of a hovered or
+   * clicked place, connection lines and entry points. Connection labels, and entry points on a
+   * light map, take a darker shade of it.
+   *
+   * @remarks
+   * A more specific setting wins for its element: `icon.default.style.fillColor` for the pin,
+   * `label.color` or a `layers.*` paint override for a label or layer. Unset, it is the map's
+   * accent colour ({@link TomTomMap.mapColors}), and without one the SDK's own colours. Cluster
+   * badges do not take it: {@link PlaceClusterBadgeConfig.color} sets them.
+   */
+  color?: string;
   /**
    * Whether the module draws anything: places, connections and entry points.
    *
    * @remarks
    * `show()` and `clear()` never change it — a hidden module keeps its data until
-   * {@link PlacesModule.setVisible} shows it again. Layers the theme does not use, and any hidden
+   * {@link PlacesModule.setVisible} shows it again. Layers the marker type does not use, and any hidden
    * through {@link PlacesModuleConfig.layers | layers}, stay hidden while the module is shown.
    *
    * @default true
    */
   visible?: boolean;
   /**
-   * Icon appearance configuration.
-   *
-   * Controls marker style and custom icons for different place categories.
+   * The default pin, and custom icons per place category.
    */
-  icon?: PlaceIconConfig;
+  icon?: PlaceIconConfig<P>;
   /**
-   * How the `pin-clustered` theme clusters places and draws the cluster badge.
+   * How the `pin-clustered` marker type clusters places and draws the cluster badge.
    */
   cluster?: PlacesClusterConfig;
   /**
-   * Text label configuration.
-   *
-   * Controls label content, styling, and positioning.
+   * The labels next to place markers: their content, styling and position.
    */
-  text?: PlaceTextConfig;
+  label?: PlaceLabelConfig<P>;
   /**
-   * Custom layer styling configuration.
+   * MapLibre overrides for the places layers, for control the other settings do not offer.
    *
    * @remarks
-   * * Overrides the default layer styling with custom specifications.
-   * * You must provide complete layer specifications for any layers you wish to customize.
-   * * You can still reuse the default configurations if you want incremental changes. See: buildPlacesLayerSpecs.
-   * * Any layer not specified will continue to use its default styling.
-   * * Use this only if you need fine MapLibre control on how places are displayed.
+   * Each override lays its `layout` and `paint` properties over the layer's own, one by one, and
+   * wins over `label` and `color` for the properties it names.
    */
   layers?: PlaceLayersConfig;
   /**
@@ -8619,7 +8783,7 @@ type PlacesModuleConfig<P extends CommonPlaceProps = CommonPlaceProps> = MapModu
    *
    *   // Computed property
    *   category: (place) => place.properties.poi?.categories?.[0],
-   *   rating: (place) => place.properties.poi?.rating || 0,
+   *   brand: (place) => place.properties.poi?.brands?.[0] ?? '',
    *   hasOpeningHours: (place) => !!place.properties.poi?.openingHours,
    *
    *   // Complex computation
@@ -8650,6 +8814,287 @@ type FeaturePropValue = string | number | boolean | null | undefined | FeaturePr
  * @group Places
  */
 type ExtraFeatureProp<P extends CommonPlaceProps = CommonPlaceProps> = FeaturePropValue | ((place: Place<P>) => FeaturePropValue);
+/**
+ * The part of a {@link PlacesModuleConfig} that survives JSON, for saving
+ * `getConfig()` and replaying it with `applyConfig()`.
+ *
+ * @remarks
+ * It leaves out what JSON cannot carry, which a replay adds back in code:
+ * - `label.title` as a function — a MapLibre expression serializes.
+ * - `connections.label`, `evAvailability.formatText` and `icon.mapping`, all functions.
+ * - `extraFeatureProps` entries that are functions — fixed values serialize.
+ * - `icon.default.image` and `icon.categoryIcons[].image` as an `HTMLImageElement` — see {@link SerializableCustomImage}.
+ *
+ * @example
+ * ```typescript
+ * const saved = JSON.stringify(places.getConfig());
+ *
+ * const state: PlacesModuleSerializableConfig = JSON.parse(saved);
+ * places.applyConfig({
+ *     ...state,
+ *     connections: { ...state.connections, label: (connection) => `${connection.distanceMeters} m` },
+ * });
+ * ```
+ *
+ * @group Places
+ */
+type PlacesModuleSerializableConfig = Omit<PlacesModuleConfig, 'label' | 'icon' | 'evAvailability' | 'connections' | 'extraFeatureProps'> & {
+  label?: Omit<PlaceLabelConfig, 'title'> & {
+    title?: Exclude<PlaceLabelConfig['title'], (place: Place) => string>;
+  };
+  icon?: Omit<PlaceIconConfig, 'default' | 'categoryIcons' | 'mapping'> & {
+    default?: Omit<DefaultPlaceIconConfig, 'image'> & {
+      image?: Omit<SerializableCustomImage, 'id'>;
+    };
+    categoryIcons?: SerializableCustomImage<MapStylePOICategory>[];
+  };
+  evAvailability?: Omit<EVAvailabilityConfig, 'formatText'>;
+  connections?: Omit<PlaceConnectionsConfig, 'label'>;
+  extraFeatureProps?: Record<string, FeaturePropValue>;
+};
+//#endregion
+//#region src/places/types/placesKnobs.d.ts
+/**
+ * The id of a places knob: its path into {@link PlacesModuleConfig}, e.g. `markerType` or
+ * `cluster.badge.color`. See {@link placesKnobCatalogue} for what each one does.
+ *
+ * @remarks
+ * Only settings that take a plain value: `label.title`, `cluster.source.clusterProperties`,
+ * `evAvailability.formatText` and anything holding an image, a callback or MapLibre layers are not
+ * knobs.
+ *
+ * @group Places
+ */
+type PlacesKnobId = 'markerType' | 'color' | 'visible' | `icon.default.style.${keyof SVGIconStyleOptions}` | `label.${Exclude<keyof PlaceLabelConfig, 'title'>}` | `cluster.badge.${Exclude<keyof PlaceClusterBadgeConfig, 'radius'>}` | `cluster.badge.radius.${keyof NonNullable<PlaceClusterBadgeConfig['radius']>}` | `cluster.source.${Exclude<keyof NonNullable<PlacesClusterConfig['source']>, 'clusterProperties'>}` | `evAvailability.${Exclude<keyof EVAvailabilityConfig, 'formatText'>}` | `entryPoints.${Exclude<keyof PlaceEntryPointsConfig, 'layers'>}`;
+/**
+ * The value type a given places knob takes: the plain value its path holds in
+ * {@link PlacesModuleConfig}. The MapLibre expressions the config also takes there are not knob
+ * values.
+ *
+ * @group Places
+ */
+type PlacesKnobValueOf<ID extends PlacesKnobId> = KnobPlainValue<ValueAt<PlacesModuleConfig, ID>>;
+/**
+ * One entry of {@link placesKnobCatalogue}. The value in force is the one at its path in
+ * {@link PlacesModule.getConfig}, else its `default`; with neither, the marker type, the map's
+ * accent or its light/dark theme decides.
+ *
+ * @group Places
+ */
+type PlacesKnob = KnobEntry<PlacesKnobId, Exclude<KnobKind, 'factor' | 'colors' | 'image'>>;
+//#endregion
+//#region src/places/knobCatalogue.d.ts
+/**
+ * Every places knob with its kind, description, range or options and, where one value holds
+ * everywhere, its default. Static data, readable with no map loaded.
+ *
+ * @remarks
+ * A knob is a plain display value in {@link PlacesModuleConfig}, at the path its id names.
+ * - Not knobs: the label `title`, `clusterProperties`, `evAvailability.formatText`,
+ *   `icon.default.image`, `icon.categoryIcons`, `icon.mapping`, `connections`, `layers`,
+ *   `extraFeatureProps` and `events`, which take callbacks, images or MapLibre values.
+ * - `entryPoints` draws nothing until it is set, and `evAvailability` until `enabled` is `true`.
+ *   `cluster` applies under the `pin-clustered` marker type only.
+ *
+ * @group Places
+ */
+export declare const placesKnobCatalogue: readonly PlacesKnob[];
+/**
+ * Every places knob id, in catalogue order.
+ *
+ * @group Places
+ */
+export declare const placesKnobIds: readonly PlacesKnobId[];
+//#endregion
+//#region src/places/types/placeDisplayProps.d.ts
+/**
+ * Properties attached to a place feature for rendering on the map.
+ *
+ * @remarks
+ * Extends the source place with display-only fields consumed by the places
+ * layer stack. Which fields are populated depends on the active
+ * {@link PlacesMarkerType | marker type}:
+ *
+ * - Every marker type uses {@link PlaceDisplayProps.iconID | iconID} — the sprite name
+ *   the main layer's `icon-image` expression binds to via `['get', 'iconID']`.
+ *   The base map's POI-Micro-like layer inherits the style's `['get','group']`
+ *   expression verbatim, so custom `PlaceIconConfig.categoryIcons` sprites only
+ *   apply to the `main` layer.
+ * - The `base-map` marker type additionally populates
+ *   {@link PlaceDisplayProps.category | category} and
+ *   {@link PlaceDisplayProps.group | group} so the base map style's own
+ *   `text-color` expression — and the POI-Micro layer's `icon-image` expression
+ *   — resolve against the place feature just as they do for native POIs.
+ *
+ * @example
+ * ```typescript
+ * const pinPlaceProps: PlaceDisplayProps = {
+ *   id: 'place-123',
+ *   title: 'Central Station',
+ *   iconID: 'poi-transit',
+ * };
+ *
+ * const baseMapPlaceProps: PlaceDisplayProps = {
+ *   id: 'place-123',
+ *   title: 'Central Station',
+ *   iconID: 'poi-railway_station',
+ *   category: 'railway_station',
+ *   group: 'transport',
+ * };
+ * ```
+ *
+ * @group Places
+ */
+export type PlaceDisplayProps = {
+  /**
+   * Unique identifier for the place feature.
+   *
+   * @remarks
+   * MapLibre does not reuse the feature IDs, so we either generate one on the
+   * fly or promote the one from `properties.id` via the source's `promoteId`
+   * option. Used for feature identification in events, hit-testing, and data
+   * updates.
+   *
+   * @example
+   * ```typescript
+   * id: 'place-123'
+   * ```
+   */
+  id: string;
+  /**
+   * Text label rendered next to the place marker.
+   *
+   * @remarks
+   * Optional — when absent no label is drawn. Typically sourced from the POI
+   * name or free-form address, but can be any custom string (e.g., configured
+   * via `PlacesModuleConfig.label.title`).
+   *
+   * @example
+   * ```typescript
+   * title: 'Amsterdam Central Station'
+   * ```
+   */
+  title?: string;
+  /**
+   * Sprite image ID used to draw the place marker.
+   *
+   * @remarks
+   * The main layer binds `icon-image` to `['get', 'iconID']`, so the sprite
+   * named here is what renders. The base map's POI-Micro-like layer inherits
+   * the style's group-driven expression verbatim and ignores this value. The
+   * sprite name is resolved per marker type: `pin` picks a POI category image of the
+   * `pinCategories` sprite, so its ID carries that sprite's namespace;
+   * `circle-icon` and `base-map` pick the base map's `poi-<category>` image; a
+   * custom `PlaceIconConfig.categoryIcons` entry overrides the default for the
+   * main layer on any marker type.
+   *
+   * @example
+   * ```typescript
+   * iconID: 'pinCategories:7315' // pin sprite
+   * iconID: 'poi-restaurant'     // circle-icon / base-map sprite
+   * iconID: 'custom-marker-0'    // user-provided custom icon
+   * ```
+   */
+  iconID: string;
+  /**
+   * Base map style POI category the place should be rendered as.
+   *
+   * @remarks
+   * Populated only for the `base-map` marker type. Values are the lowercased
+   * identifiers used by the base map style (derived via
+   * {@link toBaseMapPOICategory}). Drives the inherited `text-color`
+   * expression on the main/selected POI-like layers.
+   *
+   * @example
+   * ```typescript
+   * category: 'restaurant'
+   * category: 'hotel_or_motel'
+   * category: 'charging_location'
+   * ```
+   */
+  category?: string;
+  /**
+   * Base map style POI group the place belongs to.
+   *
+   * @remarks
+   * Populated only for the `base-map` marker type. Drives the inherited
+   * `text-color` expression on the base map's POI layers.
+   * Valid values are those produced by {@link toBaseMapPOIGroup} — e.g.,
+   * `eat_and_drink`, `lodging`, `driving`, `transport`, `shopping`,
+   * `healthcare`, `finance`, `cultural`, `leisure`, `sport`, `outdoor`,
+   * `protected`, `public`, `religion`, `military`, `business`, `education`,
+   * `parking`.
+   */
+  group?: string;
+} & SupportsEvents & Anything;
+/**
+ * Full property shape used by the PlacesModule when rendering a place: the
+ * core place data ({@link CommonPlaceProps}) merged with the display-only
+ * fields the module attaches ({@link PlaceDisplayProps}).
+ *
+ * @example
+ * ```typescript
+ * const place: DisplayPlaceProps = {
+ *   type: 'POI',
+ *   poi: {
+ *     name: 'Central Station',
+ *     categories: ['RAILWAY_STATION'],
+ *   },
+ *   address: {
+ *     streetName: 'Damrak',
+ *     municipalitySubdivision: 'Amsterdam',
+ *     countryCode: 'NL',
+ *   },
+ *   id: 'place-123',
+ *   title: 'Amsterdam Central Station',
+ *   iconID: 'poi-railway_station',
+ *   category: 'railway_station',
+ *   group: 'transport',
+ * };
+ * ```
+ *
+ * @group Places
+ */
+export type DisplayPlaceProps = CommonPlaceProps & PlaceDisplayProps;
+//#endregion
+//#region src/places/types/entryPointDisplay.d.ts
+/**
+ * Properties of an entry point drawn by {@link PlacesModule}: the {@link EntryPoint} itself, whose
+ * position is the feature geometry, plus where it came from.
+ *
+ * @group Places
+ */
+type PlaceEntryPointProps = Omit<EntryPoint, 'position'> & {
+  /**
+   * Unique identifier of the entry point feature, derived from its place.
+   */
+  id: string;
+  /**
+   * `id` of the place the entry point belongs to, as shown by the module.
+   */
+  placeID: string;
+  /**
+   * Index of the entry point in the `entryPoints` of its place.
+   */
+  entryPointIndex: number;
+} & SupportsEvents;
+/**
+ * What `places.events.entryPoints` handlers receive: the entry point as a point feature, whether its
+ * circle or its line was hit, together with the place it belongs to.
+ *
+ * @remarks
+ * The place is passed as shown, with its own geometry. To route to the entrance, pass this feature
+ * as the route location.
+ *
+ * @group Places
+ */
+type PlaceEntryPointFeature = Feature<Point, PlaceEntryPointProps & {
+  /**
+   * The place the entry point belongs to. Absent only when that place left the map while the
+   * event was being handled.
+   */
+  place?: Place<DisplayPlaceProps>;
+}>;
 //#endregion
 //#region src/places/utils/prepareConnectionsForDisplay.d.ts
 /**
@@ -8679,7 +9124,7 @@ type EntryPointFeatureCollection = FeatureCollection<Point | LineString, PlaceEn
 type PlacesSourcesAndLayers = {
   /**
    * Places source id with corresponding layers ids. Carries every layer the
-   * module owns under non-clustered themes; under `pin-clustered` it carries
+   * module owns under non-clustered marker types; under `pin-clustered` it carries
    * everything except `micro` and is configured with `cluster: true` so the
    * pin / cluster pin / cluster-badge / cluster-count / mixed-cluster
    * badge + count layers all see aggregated cluster features.
@@ -8704,6 +9149,17 @@ type PlacesSourcesAndLayers = {
 /**
  * What {@link PlacesModule.show} accepts, and what `shown-features` handlers receive back.
  *
+ * @remarks
+ * Search, geocoding, reverse geocoding and place details return places, which `show()` takes as
+ * they are; {@link preparePlacesForDisplay} is what it does to them. Three places services return
+ * something else, and no converter turns it into places:
+ *
+ * | Result | Not showable because | Show instead |
+ * | --- | --- | --- |
+ * | {@link getSearchSuggestions} | Suggestions to choose from, without geometry; the autocomplete arm inside returns `{ context, results }` segments | A place suggestion's `resolve()`, or a brand or category's `refine()` — the follow-up search |
+ * | {@link geometryData} | Polygons | With {@link GeometriesModule} |
+ * | {@link evChargingStationsAvailability} | Availability alone | {@link getPlacesWithEVAvailability} |
+ *
  * @group Places
  */
 export type ShownPlaces = Place | Place[] | Places;
@@ -8732,34 +9188,115 @@ export type PlacesEvents = CombinedEvents<MapGeoJSONFeature, PlacesModuleConfig,
   /** The entry points of places, when {@link PlacesModuleConfig.entryPoints} draws them. */
   entryPoints: UserEvents<PlaceEntryPointFeature>;
 };
-export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourcesAndLayers, PlacesModuleConfig> {
-  private layerSpecs;
-  private connectionLayerSpecs;
-  private entryPointLayerSpecs;
-  private refreshingEntryPoints;
-  private currentClusterOptions?;
-  private sourceID;
-  private unclusteredSourceID;
-  private connectionSourceID;
-  private entryPointSourceID;
-  private layerIDPrefix;
-  private defaultPlaceIconID;
-  private paintedPinStyle?;
-  private shownConnections;
-  private readonly shownFeaturesHandlers;
-  /**
-   * Creates a new module instance on the given map, waiting until the map is ready first.
-   *
-   * `PlacesModule` owns the sources, layers and images it adds, all suffixed per instance. Every
-   * call therefore returns a **new, independent** instance, and stacking several of them on one
-   * map is a supported thing to do.
-   *
-   * @param tomtomMap The TomTomMap instance.
-   * @param config  The module optional configuration
-   * @returns {Promise} Returns a promise with a new instance of this module
-   */
-  static create<P extends CommonPlaceProps = CommonPlaceProps>(tomtomMap: TomTomMap, config?: PlacesModuleConfig<P>): Promise<PlacesModule>;
+/**
+ * Map module for displaying and managing place markers.
+ *
+ * The PlacesModule provides functionality to display location markers (pins) on the map
+ * for points of interest, search results, or custom locations. It supports various marker
+ * styles, custom icons, text labels, and interactive events.
+ *
+ * @remarks
+ * **Features:**
+ * - Marker types ({@link PlacesMarkerType}): pins, circles, base-map POI look-alikes and clustered pins
+ * - One colour for the module's own drawing ({@link PlacesModuleConfig.color})
+ * - Custom icons per POI category
+ * - Text labels with styling options
+ * - Data-driven styling via MapLibre expressions
+ * - Interactive events (click, hover, etc.)
+ * - Support for custom feature properties
+ * - EV charging station availability display (opt-in)
+ * - Entry points of places, for all of them or only hovered or clicked ones (opt-in)
+ *
+ * **EV Charging Station Availability:**
+ * When displaying EV charging stations with availability data from
+ * {@link getPlacesWithEVAvailability}, the module can:
+ * - Show available/total charging points (e.g., "3/10")
+ * - Color-code availability (green = good, orange = limited, red = none/low)
+ * - Display as formatted text within the station's label
+ *
+ * This feature is disabled by default. To enable it, set `evAvailability.enabled` to `true`
+ * in the configuration.
+ *
+ * **Common Use Cases:**
+ * - Search result visualization
+ * - Custom location markers
+ * - Store locators
+ * - EV charging station maps with real-time availability
+ * - Delivery/pickup points
+ * - Saved locations display
+ *
+ * @example
+ * ```typescript
+ * // Create places module with pin markers
+ * const placesModule = await PlacesModule.create(map, {
+ *   icon: {
+ *     categoryIcons: []
+ *   },
+ *   label: {
+ *     title: (place) => place.properties.poi?.name || 'Unknown'
+ *   },
+ *   markerType: 'pin'
+ * });
+ *
+ * // Display places from search
+ * await placesModule.show(searchResults);
+ *
+ * // EV Charging Stations - Opt-in to availability display
+ * const evStations = await PlacesModule.create(map, {
+ *   evAvailability: { enabled: true }
+ * });
+ * const results = await discoverPlaces({ filters: { poiCategories: ['CHARGING_LOCATION'] } });
+ * evStations.show(await getPlacesWithEVAvailability(results)); // Shows availability
+ *
+ * // Granular control: Enable for searched stations only, background stations without
+ * const bgStations = await PlacesModule.create(map); // EV availability disabled
+ * const searched = await PlacesModule.create(map, {
+ *   evAvailability: { enabled: true }
+ * });
+ *
+ * // Handle clicks
+ * placesModule.events.on('click', (feature) => {
+ *   console.log('Clicked:', feature.properties);
+ * });
+ *
+ * placesModule.events.on('hover', (feature) => {
+ *   showTooltip(feature.properties.poi?.name);
+ * });
+ * ```
+ *
+ * @see [Places Guide](https://docs.tomtom.com/maps-sdk-js/guides/map/places)
+ *
+ * @group Places
+ */
+export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourcesAndLayers, PlacesModuleConfig> {
+  private layerSpecs;
+  private connectionLayerSpecs;
+  private entryPointLayerSpecs;
+  private refreshingEntryPoints;
+  private currentClusterOptions?;
+  private sourceID;
+  private unclusteredSourceID;
+  private connectionSourceID;
+  private entryPointSourceID;
+  private layerIDPrefix;
+  private defaultPlaceIconID;
+  private paintedPinStyle?;
+  private shownConnections;
+  private readonly shownFeaturesHandlers;
+  /**
+   * Creates a new module instance on the given map, waiting until the map is ready first.
+   *
+   * `PlacesModule` owns the sources, layers and images it adds, all suffixed per instance. Every
+   * call therefore returns a **new, independent** instance, and stacking several of them on one
+   * map is a supported thing to do.
+   *
+   * @param tomtomMap The TomTomMap instance.
+   * @param config  The module optional configuration
+   * @returns {Promise} Returns a promise with a new instance of this module
+   */
+  static create<P extends CommonPlaceProps = CommonPlaceProps>(tomtomMap: TomTomMap, config?: PlacesModuleConfig<P>): Promise<PlacesModule>;
   private constructor();
+  private colorOf;
   /**
    * @ignore
    */
@@ -8784,33 +9321,12 @@ export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourc
    */
   protected restoreDataAndConfigImpl(): void;
   /**
-   * Updates the visual theme for displayed places.
-   *
-   * @param theme - The theme style to apply to place markers.
+   * Changes the {@link PlacesMarkerType | kind of marker} places are drawn with.
    *
    * @remarks
-   * **Available Themes:**
-   * - `pin`: Traditional teardrop-shaped map pins
-   * - `circle-icon`: Simple circular markers (previously named `circle`)
-   * - `base-map`: Mimics the map's built-in POI layer style with category icons (combines `main`, `selected`, and `micro`). For micro-only rendering, hide the `main` layer via `layers.main.layout.visibility = 'none'`.
-   * - `pin-clustered`: `pin` markers that merge into counted clusters while zoomed out, configured by {@link PlacesModuleConfig.cluster}.
-   *
-   * Changes apply immediately to all currently shown places. Other configuration
-   * properties (icon config, text config) remain unchanged.
-   *
-   * @example
-   * ```typescript
-   * // Switch to pin markers
-   * placesModule.applyTheme('pin');
-   *
-   * // Use simple circles
-   * placesModule.applyTheme('circle-icon');
-   *
-   * // Match map's POI style (ideal to blend in)
-   * placesModule.applyTheme('base-map');
-   * ```
+   * Redraws the places already shown, and leaves the rest of the configuration as it is.
    */
-  applyTheme(theme: PlacesTheme): void;
+  applyMarkerType(markerType: PlacesMarkerType): void;
   /**
    * Updates the icon configuration for displayed places.
    *
@@ -8825,16 +9341,14 @@ export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourc
    * ```typescript
    * placesModule.applyIconConfig({
    *   categoryIcons: [
-   *     { category: 'RESTAURANT', id: 'restaurant-icon', image: '/icons/food.png' }
+   *     { id: 'RESTAURANT', image: '/icons/food.png' }
    *   ]
    * });
    * ```
    */
-  applyIconConfig(iconConfig: PlaceIconConfig): void;
+  applyIconConfig<P extends CommonPlaceProps = CommonPlaceProps>(iconConfig: PlaceIconConfig<P>): void;
   /**
-   * Updates the text/label configuration for displayed places.
-   *
-   * @param textConfig - New text configuration settings.
+   * Replaces the {@link PlacesModuleConfig.label | label} configuration of the displayed places.
    *
    * @remarks
    * Supports both functions and MapLibre expressions for dynamic text.
@@ -8842,19 +9356,19 @@ export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourc
    * @example
    * ```typescript
    * // Use function
-   * placesModule.applyTextConfig({
-   *   field: (place) => place.properties.poi?.name || 'Unknown'
+   * placesModule.applyLabelConfig({
+   *   title: (place) => place.properties.poi?.name || 'Unknown'
    * });
    *
    * // Use MapLibre expression
-   * placesModule.applyTextConfig({
-   *   field: ['get', 'title'],
+   * placesModule.applyLabelConfig({
+   *   title: ['get', 'title'],
    *   size: 14,
    *   color: '#333'
    * });
    * ```
    */
-  applyTextConfig(textConfig: PlaceTextConfig): void;
+  applyLabelConfig<P extends CommonPlaceProps = CommonPlaceProps>(label: PlaceLabelConfig<P>): void;
   private applyConfigPart;
   /**
    * Applies additional feature properties to displayed places.
@@ -8868,34 +9382,16 @@ export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourc
    * ```typescript
    * placesModule.applyExtraFeatureProps({
    *   category: (place) => place.properties.poi?.localizedCategories?.[0],
-   *   rating: (place) => place.properties.poi?.rating || 0,
+   *   brand: (place) => place.properties.poi?.brands?.[0] ?? '',
    *   isOpen: true
    * });
    * ```
    */
   applyExtraFeatureProps<P extends CommonPlaceProps = CommonPlaceProps>(extraFeatureProps: NonNullable<PlacesModuleConfig<P>['extraFeatureProps']>): void;
-  /**
-   * Shows or hides everything the module draws: places, connections and entry points.
-   *
-   * @remarks
-   * `show()` and `clear()` never change it: a hidden module keeps its data and draws it again on
-   * `setVisible(true)`. Showing leaves hidden what the theme does not use, and any layer hidden
-   * through `layers.*.layout.visibility`.
-   *
-   * @example
-   * ```typescript
-   * places.setVisible(false);
-   * await places.show(results); // stays hidden
-   * places.setVisible(true);
-   * ```
-   */
-  setVisible(visible: boolean): void;
-  /**
-   * Whether the module is set to be shown ({@link PlacesModuleConfig.visible}). A shown module
-   * with no places draws nothing.
-   */
-  isVisible(): boolean;
+  /** @ignore */
+  protected applyVisibility(config: PlacesModuleConfig | undefined): void;
   private updateLayersAndData;
+  private updatePlacesLayers;
   private rebuildSourcesAndLayers;
   private updateConnectionsData;
   private updateEntryPointsData;
@@ -8913,9 +9409,13 @@ export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourc
    *
    * @remarks
    * **Behavior:**
-   * - Replaces any previously shown places
+   * - Replaces any previously shown places, and never merges with them
+   * - Drops the event states of the places it replaces, even of a place shown again under the same
+   *   id: an event state lives on the shown feature, so re-select with {@link putEventState} by id.
+   *   Places that carry `properties.eventState`, such as `getShown().places`, keep theirs
+   * - Drops the shown connections (see {@link PlaceConnectionDisplay})
    * - Applies current module styling configuration
-   * - Automatically generates labels if text config is set
+   * - Automatically generates labels if label config is set
    * - Waits for module to be ready before displaying
    *
    * **Data Sources:**
@@ -8923,6 +9423,8 @@ export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourc
    * - Custom place objects matching the Place interface
    * - GeoJSON Point features
    *
+   * {@link ShownPlaces} names the places services whose results are not places, and what shows them.
+   *
    * @example
    * Display search results:
    * ```typescript
@@ -8956,7 +9458,7 @@ export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourc
    * Removes all places from the map.
    *
    * @remarks
-   * - Clears all displayed places
+   * - Clears all displayed places, their event states and the shown connections
    * - Does not reset styling configuration
    * - Module remains initialized and ready for new data
    *
@@ -9018,7 +9520,9 @@ export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourc
    * @returns The places currently displayed on the map.
    *
    * @remarks
-   * Returns the exact data that was passed to the `show()` method.
+   * `places` are the places given to `show()` as drawn: each carries the {@link PlaceDisplayProps}
+   * and its current `eventState`. `connections` are the ones given to `showConnections()`, including
+   * any skipped for an id no shown place has.
    *
    * @example
    * ```typescript
@@ -9038,6 +9542,10 @@ export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourc
    * @remarks
    * Use this to make places appear clicked or hovered programmatically.
    *
+   * The state lives on the shown place: a style change, `applyConfig` and a marker type change keep
+   * it, while {@link show} of new results, {@link clear} and a `setStyle` with `resetState` drop
+   * it, whatever the ids.
+   *
    * @example
    * ```typescript
    * // Make first place appear clicked
@@ -9080,9 +9588,18 @@ export declare class PlacesModule extends AbstractDataOwnedMapModule<PlacesSourc
 //#endregion
 //#region src/places/utils/preparePlacesForDisplay.d.ts
 /**
- * Builds the title of the place to display it on the map.
- * @param place The place to display.
- * @ignore
+ * The label {@link PlacesModule} gives a place when {@link PlaceLabelConfig.title} is not a function:
+ * the POI name, else the free-form address.
+ *
+ * @example
+ * ```typescript
+ * // Brand first, the default label otherwise
+ * const places = await PlacesModule.create(map, {
+ *   label: { title: (place) => place.properties.poi?.brands?.[0] ?? buildPlaceTitle(place) },
+ * });
+ * ```
+ *
+ * @group Places
  */
 export declare const buildPlaceTitle: (place: Place) => string;
 /**
@@ -9102,22 +9619,49 @@ export declare const getPOILayerCategoryForPlace: (place: Place, config?: Places
  */
 export declare const getPOIGroupForPlace: (place: Place, config?: PlacesModuleConfig) => string | undefined;
 /**
- * Transforms the input of a "show" call to FeatureCollection "Places".
- * @ignore
- */
-export declare const toPlaces: (places: Place | Place[] | Places) => Places;
-/**
- * prepare places features to be displayed on map by adding needed  properties for title, icon and style
- * @ignore
+ * Turns any of the shapes {@link PlacesModule.show} accepts into one {@link Places} collection.
+ *
+ * @remarks
+ * A `shown-features` handler receives the input of `show()` as it was given, in any of those shapes.
+ *
+ * @example
+ * ```typescript
+ * places.events.on('shown-features', (shown) => {
+ *   if ('places' in shown) renderResultList(toPlaces(shown.places).features);
+ * });
+ * ```
+ *
+ * @group Places
  */
-export declare const preparePlacesForDisplay: (placesInput: Place | Place[] | Places, instanceIndex: number, config?: PlacesModuleConfig) => Places<DisplayPlaceProps>;
-//#endregion
-//#region src/pois/layers/poisLayers.d.ts
+export declare const toPlaces: (places: ShownPlaces) => Places;
 /**
- * Layer IDs for POIs on the map.
- * @ignore
+ * What {@link PlacesModule.show} does to the places it is given before drawing them.
+ *
+ * @remarks
+ * `show()` calls it itself; call it to see what the layers, `layers.*` overrides and click handlers
+ * read. Each place keeps its properties and gains the {@link PlaceDisplayProps}:
+ *
+ * - `id`: the place's, or a generated one, copied into `properties` for MapLibre's `promoteId`
+ * - `title`: {@link PlaceLabelConfig.title} when it is a function, else {@link buildPlaceTitle}
+ * - `iconID`: the image the marker type and {@link PlaceIconConfig} pick
+ * - `category` and `group` under the `base-map` and `pin-clustered` marker types
+ * - every {@link PlacesModuleConfig.extraFeatureProps} entry, and the EV availability ones when
+ *   {@link EVAvailabilityConfig.enabled} is set
+ *
+ * An `iconID` naming an image the module adds itself, the default pin or a
+ * {@link PlaceIconConfig.categoryIcons} entry, is the first module's name for it.
+ * {@link PlacesModule.getShown} returns a given module's places as it drew them.
+ *
+ * @example
+ * ```typescript
+ * const [first] = preparePlacesForDisplay(await discoverPlaces({ query: 'coffee' }), { markerType: 'base-map' }).features;
+ * first.properties.title; // what the label shows
+ * first.properties.category; // what the base-map look keys its colour on
+ * ```
+ *
+ * @group Places
  */
-export declare const poiLayerIDs: string[];
+export declare const preparePlacesForDisplay: <P extends CommonPlaceProps = CommonPlaceProps>(shownPlaces: ShownPlaces, config?: PlacesModuleConfig<P>) => Places<DisplayPlaceProps>;
 //#endregion
 //#region src/pois/types/poiCategoryGroups.d.ts
 /**
@@ -9156,12 +9700,7 @@ export declare const poiLayerIDs: string[];
  * @example
  * Use with POI module filtering:
  * ```ts
- * poisModule.configure({
- *   categoryFilter: {
- *     mode: 'show',
- *     values: ['FOOD_DRINKS_GROUP', 'ENTERTAINMENT_GROUP']
- *   }
- * });
+ * poisModule.filterCategories({ show: 'only', values: ['FOOD_DRINKS_GROUP', 'ENTERTAINMENT_GROUP'] });
  * ```
  *
  * @see {@link POICategoryGroup} - Type representing all available group names
@@ -9169,7 +9708,21 @@ export declare const poiLayerIDs: string[];
  *
  * @group POIs
  */
-export declare const poiCategoryGroups: Record<string, MapStylePOICategory[]>;
+export declare const poiCategoryGroups: {
+  FOOD_DRINKS_GROUP: ("CAFE_PUB" | "DELICATESSEN" | "FAST_FOOD" | "PUB" | "RESTAURANT" | "SOUL_FOOD" | "WINERY")[];
+  SHOPPING_GROUP: ("CLOTHING_SHOP" | "CONVENIENCE_STORE" | "DEPARTMENT_STORE" | "ELECTRICAL_APPLIANCES_SHOP" | "FOOD_MARKET" | "GROCERY_STORE" | "HARDWARE_STORE" | "MALL" | "MARKETPLACE" | "SHOP_OR_STORE" | "SUPERMARKET")[];
+  TRANSPORTATION_GROUP: ("AIRPORT" | "BUS_STOP" | "FERRY_TERMINAL" | "HELIPORT_OR_HELIPAD" | "PUBLIC_TRANSPORT_STOP" | "RAILWAY_STATION" | "TAXI_STAND")[];
+  HEALTH_GROUP: ("DENTIST" | "DOCTOR" | "EMERGENCY_MEDICAL_SERVICE" | "EMERGENCY_ROOM" | "HEALTHCARE_SERVICE" | "HOSPITAL" | "PHARMACY" | "WELFARE_ORGANIZATION")[];
+  PARKING_GROUP: ("OPEN_CAR_PARKING_AREA" | "PARKING_GARAGE")[];
+  HOLIDAY_TOURISM_GROUP: ("AMUSEMENT_PARK" | "BEACH" | "HOLIDAY_RENTAL" | "LEISURE_CENTER" | "MOUNTAIN_PASS" | "MOUNTAIN_PEAK" | "MUSEUM" | "NATURAL_FEATURE" | "TOURIST_ATTRACTION" | "TOURIST_INFORMATION" | "VIEWPOINT")[];
+  EV_CHARGING_STATIONS_GROUP: "CHARGING_LOCATION"[];
+  GAS_STATIONS_GROUP: "FUEL_STATION"[];
+  ACCOMMODATION_GROUP: ("CAMPING_GROUND" | "HOLIDAY_RENTAL" | "HOTEL_OR_MOTEL")[];
+  ENTERTAINMENT_GROUP: ("CASINO_AND_GAMBLING" | "CINEMA" | "CLUB_AND_ASSOCIATION" | "CONCERT_HALL" | "ENTERTAINMENT" | "MOVIE_THEATER" | "NIGHTLIFE" | "THEATER")[];
+  SPORTS_LEISURE_GROUP: ("BEACH" | "GOLF_COURSE" | "ICE_RINK" | "LEISURE_CENTER" | "MOUNTAIN_PASS" | "MOUNTAIN_PEAK" | "SPORTS_CENTER" | "STADIUM" | "SWIMMING_POOL" | "WATER_SPORT")[];
+  EDUCATION_GROUP: ("COLLEGE_OR_UNIVERSITY" | "CULTURAL_CENTER" | "PUBLIC_LIBRARY" | "SCHOOL")[];
+  GOVERNMENT_GROUP: ("COURTHOUSE" | "EMBASSY" | "FIRE_STATION" | "GOVERNMENT_OFFICE" | "POLICE_STATION")[];
+};
 /**
  * POI category group type.
  *
@@ -9356,6 +9909,55 @@ type POIsModuleConfig = MapModuleCommonConfig & {
   };
 };
 //#endregion
+//#region src/pois/types/poisKnobs.d.ts
+/**
+ * The id of a POIs knob: its path into {@link POIsModuleConfig}. See {@link poisKnobCatalogue} for
+ * what each one does.
+ *
+ * @group POIs
+ */
+type POIsKnobId = 'visible' | `filters.categories.${keyof ValuesFilter<unknown>}`;
+/**
+ * The value type a given POIs knob takes: the plain value its path holds in {@link POIsModuleConfig}.
+ *
+ * @group POIs
+ */
+type POIsKnobValueOf<ID extends POIsKnobId> = KnobPlainValue<ValueAt<POIsModuleConfig, ID>>;
+/**
+ * One entry of {@link poisKnobCatalogue}. The value in force is the one at its path in
+ * {@link POIsModule.getConfig}, else its `default`.
+ *
+ * @group POIs
+ */
+type POIsKnob = KnobEntry<POIsKnobId, 'toggle' | 'enum' | 'enums'>;
+//#endregion
+//#region src/pois/knobCatalogue.d.ts
+/**
+ * Every POIs knob with its kind, description, options and, where one value holds everywhere, its
+ * default. Static data, readable with no map loaded.
+ *
+ * @remarks
+ * A knob is a plain display value in {@link POIsModuleConfig}, at the path its id names: whether
+ * POIs show, and which categories. Not knobs: `events`. How the POIs look — size, zoom, label
+ * colours, micro markers — is the `pois.*` {@link StylingModule} knobs'.
+ *
+ * @group POIs
+ */
+export declare const poisKnobCatalogue: readonly POIsKnob[];
+/**
+ * Every POIs knob id, in catalogue order.
+ *
+ * @group POIs
+ */
+export declare const poisKnobIds: readonly POIsKnobId[];
+//#endregion
+//#region src/pois/layers/poisLayers.d.ts
+/**
+ * Layer IDs for POIs on the map.
+ * @ignore
+ */
+export declare const poiLayerIDs: string[];
+//#endregion
 //#region src/pois/types/poisModuleFeature.d.ts
 /**
  * A GeoJSON feature representing a POI from the vector tile map.
@@ -9462,6 +10064,7 @@ type PoIsSourcesAndLayers = {
  * `pois.microMarkers` hides the micro markers within the POIs this module shows, and never shows
  * them while this module hides the POIs.
  * See [Who owns what](https://docs.tomtom.com/maps-sdk-js/guides/map/modules#who-owns-what).
+ * {@link poisKnobCatalogue} lists the settings of its configuration a knob holds.
  *
  * **Features:**
  * - Toggle POI visibility on/off
@@ -9591,9 +10194,9 @@ export declare class POIsModule extends AbstractStyleOwnedMapModule<PoIsSourcesA
    */
   protected _applyConfig(config: POIsModuleConfig | undefined): POIsModuleConfig | undefined;
   /**
-   * Checks if POI layers are currently visible.
+   * Whether the POIs are set to be shown.
    *
-   * @returns `true` if at least one POI layer is visible, `false` if all are hidden.
+   * @returns The `visible` setting; while nothing has set it, whether the style draws any POI layer.
    *
    * @example
    * ```typescript
@@ -10349,16 +10952,13 @@ type ChargingStopIconConfig = {
   mapping?: ChargingStopIconMapping;
 };
 /**
- * Text display configuration for charging stops along the route.
- *
- * @remarks
- * Controls the visibility and content of text labels associated with charging stop markers.
+ * The labels beside the charging stop markers along the route: whether they show, and their text.
  *
  * @group Routing
  */
-type ChargingStopTextConfig = {
+type ChargingStopLabelConfig = {
   /**
-   * Controls the visibility of text labels for charging stops.
+   * Controls the visibility of the charging stop labels.
    *
    * @defaultValue true
    */
@@ -10389,12 +10989,9 @@ type ChargingStopsConfig = {
    */
   visible?: boolean;
   /**
-   * Display configuration for charging stop text labels.
-   *
-   * @remarks
-   * Can control both content and display properties of the text shown next to charging stop icons.
+   * The labels beside the charging stop icons: whether they show, and their text.
    */
-  text?: ChargingStopTextConfig;
+  label?: ChargingStopLabelConfig;
   /**
    * Display configuration for charging stop icons.
    */
@@ -10470,8 +11067,9 @@ type RouteWidth = 's' | 'm' | 'l';
  * Route waypoint icon size preset.
  *
  * @remarks
- * Controls the scale of waypoint pin icons at all zoom levels: `"s"` is 0.75 × `"m"` and `"l"` is
- * 1.25 × `"m"`. {@link RoutingModuleConfig.waypointSizeFactor} multiplies whichever preset applies.
+ * Controls the scale of waypoint pins, and of the stop number inside them, at all zoom levels:
+ * `"s"` is 0.75 × `"m"` and `"l"` is 1.25 × `"m"`. {@link RoutingModuleConfig.waypointSizeFactor}
+ * multiplies whichever preset applies.
  *
  * Available options:
  * - `"s"` - Small icons
@@ -10481,6 +11079,15 @@ type RouteWidth = 's' | 'm' | 'l';
  * @group Routing
  */
 type RouteWaypointSize = 's' | 'm' | 'l';
+/**
+ * Where a section's icon sits on it.
+ *
+ * - `center`: one icon at the middle of each section.
+ * - `along`: icons repeated along the section.
+ *
+ * @group Routing
+ */
+type SectionIconPlacement = 'center' | 'along';
 /**
  * The icon drawn on a route section.
  *
@@ -10499,18 +11106,15 @@ type SectionIconConfig = {
   /**
    * Where the icon sits on the section.
    *
-   * @remarks
-   * - `center`: one icon at the middle of each section.
-   * - `along`: icons repeated along the section.
-   *
    * @defaultValue `"center"` on the generated types; the bespoke types that draw an icon keep their own placement.
    */
-  placement?: 'center' | 'along';
+  placement?: SectionIconPlacement;
   /**
-   * Icon scale, where `1` is the sprite image's own size. Clamped to
-   * {@link SECTION_ICON_SIZE_FACTOR_RANGE}, 0.25 to 2.
+   * Multiplier over the size the type draws its icon at: the sprite image's own size on the
+   * generated types, the zoom-ramped size on `ferry`, `tollRoad`, `tunnel` and
+   * `vehicleRestricted`. Clamped to {@link SECTION_ICON_SIZE_FACTOR_RANGE}, 0.25 to 2.
    *
-   * @defaultValue `1` on the generated types; the bespoke types that draw an icon keep their own zoom-ramped size.
+   * @defaultValue `1`
    */
   sizeFactor?: number;
 };
@@ -10806,21 +11410,32 @@ type RoutingBeforeLayerConfig = PartsBeforeLayerConfig<'mainLines' | 'instructio
  * Provides customization options for route visualization and behavior,
  * including display units, waypoint handling, and layer styling.
  *
+ * @see {@link RoutingModuleSerializableConfig} for the part that survives JSON.
+ *
  * @group Routing
  */
 type RoutingModuleConfig = MapModuleCommonConfig & {
   /**
-   * Units for displaying distances in route summaries and instructions.
+   * Whether the module draws anything: route lines, waypoints, sections, guidance, charging stops,
+   * summary bubbles and border crossings.
    *
    * @remarks
-   * Overrides the global configuration setting for display units.
-   * Affects distance values shown in route summaries and turn-by-turn instructions.
+   * `showRoutes()`, `showWaypoints()` and the clear methods never change it — a hidden module keeps
+   * its data until {@link RoutingModule.setVisible} shows it again. While shown, each part's own
+   * `visible` (`sections.<type>.visible`, `summaryBubbles.visible`, …) still decides whether it draws.
    *
-   * Available options:
-   * - `metric` - Kilometers and meters
-   * - `imperial` - Miles and feet
+   * @default true
+   */
+  visible?: boolean;
+  /**
+   * Units of the distances and durations the module writes on the map.
+   *
+   * @remarks
+   * Laid over the global configuration's display units field by field: a field left unset keeps
+   * the global value. `distance.type` picks the unit system (`metric`, `imperial_us` or
+   * `imperial_uk`); the other fields relabel the units.
    *
-   * @defaultValue `"metric"`
+   * @defaultValue the global configuration's `displayUnits`
    */
   displayUnits?: DisplayUnits;
   /**
@@ -10845,7 +11460,7 @@ type RoutingModuleConfig = MapModuleCommonConfig & {
    *
    * @remarks
    * Clamped to {@link ROUTE_WIDTH_FACTOR_RANGE}, 0.5 to 2. Sections without a `widthFactor` of
-   * their own follow it.
+   * their own follow it, and so do the instruction arrows, which no preset resizes.
    *
    * @defaultValue `1`
    */
@@ -10937,6 +11552,82 @@ type RoutingModuleConfig = MapModuleCommonConfig & {
    */
   layers?: RouteLayersConfig;
 };
+/**
+ * The part of a {@link RoutingModuleConfig} that survives JSON, for saving
+ * `getConfig()` and replaying it with `applyConfig()`.
+ *
+ * @remarks
+ * It leaves out what JSON cannot carry, which a replay adds back in code:
+ * - `chargingStops.icon.mapping` with `basedOn: 'custom'`, whose `fn` is a function.
+ * - `chargingStops.icon.customIcons[].image` as an `HTMLImageElement` — see {@link SerializableCustomImage}.
+ *
+ * @group Routing
+ */
+type RoutingModuleSerializableConfig = Omit<RoutingModuleConfig, 'chargingStops'> & {
+  chargingStops?: Omit<ChargingStopsConfig, 'icon'> & {
+    icon?: Omit<ChargingStopIconConfig, 'customIcons' | 'mapping'> & {
+      customIcons?: SerializableCustomImage[];
+      mapping?: Extract<ChargingStopIconMapping, {
+        basedOn: 'chargingSpeed';
+      }>;
+    };
+  };
+};
+//#endregion
+//#region src/routing/types/routingKnobs.d.ts
+type LeafPathOf<T> = { [KEY in keyof T & string]-?: NonNullable<T[KEY]> extends object ? `${KEY}.${keyof NonNullable<T[KEY]> & string}` : KEY; }[keyof T & string];
+/**
+ * The id of a routing knob: its path into {@link RoutingModuleConfig}, e.g. `widthFactor` or
+ * `sections.tunnel.color`. See {@link routingKnobCatalogue} for what each one does.
+ *
+ * @remarks
+ * Each section type contributes only the knobs {@link SectionKnobOf} lists for it.
+ *
+ * @group Routing
+ */
+type RoutingKnobId = 'visible' | 'color' | 'width' | 'widthFactor' | 'waypointSize' | 'waypointSizeFactor' | `waypoints.icon.style.${keyof SVGIconStyleOptions}` | 'waypoints.entryPoints' | `displayUnits.distance.${keyof DistanceDisplayUnits}` | `displayUnits.time.${keyof TimeDisplayUnits}` | 'chargingStops.visible' | 'chargingStops.label.visible' | 'summaryBubbles.visible' | `countryCrossings.${keyof CountryCrossingConfig}` | { [T in DrawnSectionType]: `sections.${T}.${LeafPathOf<SectionDisplayConfig<T>>}`; }[DrawnSectionType];
+/**
+ * The value type a given routing knob takes: the plain value its path holds in {@link RoutingModuleConfig}.
+ *
+ * @group Routing
+ */
+type RoutingKnobValueOf<ID extends RoutingKnobId> = KnobPlainValue<ValueAt<RoutingModuleConfig, ID>>;
+/**
+ * One entry of {@link routingKnobCatalogue}. The value in force is the one at its path in
+ * {@link RoutingModule.getConfig}, else its `default`; with neither, the style or the global config
+ * decides.
+ *
+ * @group Routing
+ */
+type RoutingKnob = KnobEntry<RoutingKnobId, Exclude<KnobKind, 'offset' | 'enums' | 'colors'>>;
+//#endregion
+//#region src/routing/knobCatalogue.d.ts
+/**
+ * Every routing knob with its kind, description, range or options and, where one value holds
+ * everywhere, its default: the route-wide knobs first, then each drawn section type's. Static data,
+ * readable with no map loaded.
+ *
+ * @remarks
+ * A knob is a plain display value in {@link RoutingModuleConfig}, at the path its id names. Not
+ * knobs: `layers`, `beforeLayerConfig` and the charging stop icons and title, which take structured
+ * or MapLibre values, and `events`. A `displayUnits` knob left unset follows the global config.
+ *
+ * @group Routing
+ */
+export declare const routingKnobCatalogue: readonly RoutingKnob[];
+/**
+ * Every routing knob id, in catalogue order.
+ *
+ * @group Routing
+ */
+export declare const routingKnobIds: readonly RoutingKnobId[];
+//#endregion
+//#region src/routing/layers/routeTrafficSectionLayers.d.ts
+/**
+ * The colour of each delay magnitude a route's traffic section is drawn in.
+ * @ignore
+ */
+type TrafficDelayColors = Record<Extract<DelayMagnitude, 'minor' | 'moderate' | 'major'>, string>;
 //#endregion
 //#region src/routing/layers/routingLayers.d.ts
 /**
@@ -10947,9 +11638,10 @@ type RoutingModuleConfig = MapModuleCommonConfig & {
  * @param lightDark - The map style's light/dark theme, which the country crossing plaque colours follow.
  * @param existingLayerID - The anchor a configured `beforeLayerConfig` target resolves to, given the
  * layer it names: that layer when the style has it, else undefined for the top of the stack.
+ * @param trafficColors - The colours traffic sections draw each delay magnitude in.
  * @ignore
  */
-export declare const buildRoutingLayers: (config?: RoutingModuleConfig, layerIDPrefix?: string, instanceIndex?: number, lightDark?: LightDark, existingLayerID?: (layerID: string | undefined) => string | undefined) => Required<RouteLayersConfig>;
+export declare const buildRoutingLayers: (config?: RoutingModuleConfig, layerIDPrefix?: string, instanceIndex?: number, lightDark?: LightDark, existingLayerID?: (layerID: string | undefined) => string | undefined, trafficColors?: TrafficDelayColors) => Required<RouteLayersConfig>;
 /**
  * Default routing layers configuration. Calls routingLayers with no parameters.
  *
@@ -11053,11 +11745,17 @@ export declare const ROUTE_WAYPOINT_SIZE_FACTOR_RANGE: KnobRange;
  * The values {@link SectionIconConfig.sizeFactor} is clamped to.
  *
  * @remarks
- * Relative to the sprite image, which the built-in section icons already draw at 0.5 to 1 of: down
- * to half that, and up to twice the image.
+ * From a quarter of the size the section type draws its icon at, to twice that size.
  * @group Routing
  */
 export declare const SECTION_ICON_SIZE_FACTOR_RANGE: KnobRange;
+type IconSize = NonNullable<SymbolLayerSpecification['layout']>['icon-size'];
+/**
+ * The icon size of a section layer under the given {@link SectionIconConfig.sizeFactor}: the size
+ * the layer draws, MapLibre's `1` where it sets none, times the clamped factor.
+ * @ignore
+ */
+export declare const getSectionIconSize: (layerIconSize: IconSize, sizeFactor: number) => IconSize;
 /**
  * How thick a route line is drawn: a preset and a multiplier over it.
  * @ignore
@@ -11078,6 +11776,15 @@ export declare const getLineOutlineWidth: (lineWidth?: RouteLineWidth) => Expres
  * @ignore
  */
 export declare const getWaypointIconSize: (size?: RouteWaypointSize, sizeFactor?: number) => ExpressionSpecification;
+/**
+ * Returns the text size expression of the stop number drawn inside a waypoint pin.
+ *
+ * @remarks
+ * Scales with the pin by {@link getWaypointIconSize}'s factor: the number's offset is in ems, so
+ * it stays inside the pin head at every size.
+ * @ignore
+ */
+export declare const getWaypointIndexTextSize: (size?: RouteWaypointSize, sizeFactor?: number) => ExpressionSpecification;
 /**
  * Returns the width expression of a section halo for the given width.
  *
@@ -11097,6 +11804,14 @@ export declare const getInstructionLineWidth: (lineWidth?: RouteLineWidth) => Ex
  * @ignore
  */
 export declare const getInstructionOutlineWidth: (lineWidth?: RouteLineWidth) => ExpressionSpecification;
+/**
+ * Returns the instruction arrow icon size expression for the given width.
+ *
+ * @remarks
+ * Only `widthFactor` scales it, not the preset.
+ * @ignore
+ */
+export declare const getInstructionArrowSize: (lineWidth?: RouteLineWidth) => ExpressionSpecification;
 /**
  * @ignore
  */
@@ -11992,6 +12707,7 @@ export declare class RoutingModule extends AbstractDataOwnedMapModule<RoutingSou
   private layersSpecs;
   private layerIDPrefix;
   private appliedRouteColor?;
+  private appliedDisplayUnits?;
   private readonly shownFeaturesHandlers;
   /**
    * Make sure the map is ready before create an instance of the module and any other interaction with the map
@@ -12006,9 +12722,8 @@ export declare class RoutingModule extends AbstractDataOwnedMapModule<RoutingSou
    * map is a supported thing to do.
    *
    * **Configuration Options:**
-   * - `displayUnits`: Distance units (metric/imperial)
-   * - `waypointsSource`: Waypoint entry point options
-   * - `layers`: Complete layer styling configuration
+   * {@link routingKnobCatalogue} lists every plain-valued display setting; `layers` takes complete
+   * MapLibre layer specs.
    *
    * **Default Styling:**
    * If no custom layers are provided, uses {@link defaultRoutingLayers}.
@@ -12023,8 +12738,8 @@ export declare class RoutingModule extends AbstractDataOwnedMapModule<RoutingSou
    * With custom configuration:
    * ```typescript
    * const routingModule = await RoutingModule.create(map, {
-   *   displayUnits: 'imperial',
-   *   waypointsSource: {
+   *   displayUnits: { distance: { type: 'imperial_us' } },
+   *   waypoints: {
    *     entryPoints: 'main-when-available'
    *   }
    * });
@@ -12032,6 +12747,7 @@ export declare class RoutingModule extends AbstractDataOwnedMapModule<RoutingSou
    */
   static create(tomtomMap: TomTomMap, config?: RoutingModuleConfig): Promise<RoutingModule>;
   private constructor();
+  private repaintTrafficSections;
   private routeColorOf;
   private buildLayersSpecs;
   private createSourcesWithLayers;
@@ -12042,7 +12758,7 @@ export declare class RoutingModule extends AbstractDataOwnedMapModule<RoutingSou
   /**
    * @ignore
    */
-  protected _applyConfig(config?: RoutingModuleConfig): RoutingModuleConfig;
+  protected _applyConfig(config?: RoutingModuleConfig): RoutingModuleConfig | undefined;
   /**
    * Shows the speed limit sections, each carrying the sign that posts it.
    *
@@ -12086,16 +12802,19 @@ export declare class RoutingModule extends AbstractDataOwnedMapModule<RoutingSou
    */
   private reshowSpeedLimitSigns;
   /**
-   * Applies the `sections.<type>.visible` knob to every section type.
+   * Draws each part while its source holds features and the module is visible, and a section type
+   * only while its `sections.<type>.visible` is on as well.
    *
    * @remarks
-   * Every other source here follows one rule — its layers are visible whenever it holds features
-   * — and for sections that rule is not enough. Almost every route has urban stretches, a tunnel
-   * or a country crossing somewhere along it, so "has features" would draw all sixteen types the
-   * moment a route is shown, whatever the caller asked for. This runs right after anything that
-   * shows features and after any config change, in the same tick, so nothing renders in between.
+   * "Has features" alone is not enough for sections. Almost every route has urban stretches, a
+   * tunnel or a country crossing somewhere along it, so it would draw all fifteen types the moment
+   * a route is shown, whatever the caller asked for.
+   *
+   * This runs right after anything that shows features and after any config change, in the same
+   * tick, so nothing renders in between.
+   * @ignore
    */
-  private applySectionVisibility;
+  protected applyVisibility(config: RoutingModuleConfig | undefined): void;
   /** The id of the layer posting this type's signs, for a type that posts them. */
   private signLayerID;
   /**
@@ -12385,6 +13104,47 @@ type TerrainModuleConfig = MapModuleCommonConfig & {
   elevationExaggeration?: number;
 };
 //#endregion
+//#region src/terrain/types/terrainKnobs.d.ts
+/**
+ * The id of a terrain knob: its path into {@link TerrainModuleConfig}, e.g. `hillshade` or
+ * `elevationExaggeration`. See {@link terrainKnobCatalogue} for what each one does.
+ *
+ * @group Terrain
+ */
+type TerrainKnobId = Exclude<keyof TerrainModuleConfig, keyof MapModuleCommonConfig>;
+/**
+ * The value type a given terrain knob takes: the plain value its path holds in {@link TerrainModuleConfig}.
+ *
+ * @group Terrain
+ */
+type TerrainKnobValueOf<ID extends TerrainKnobId> = KnobPlainValue<ValueAt<TerrainModuleConfig, ID>>;
+/**
+ * One entry of {@link terrainKnobCatalogue}. The value in force is the one at its path in
+ * {@link TerrainModule.getConfig}, else its `default`; with neither, the map's own terrain decides.
+ *
+ * @group Terrain
+ */
+type TerrainKnob = KnobEntry<TerrainKnobId, 'toggle' | 'number'>;
+//#endregion
+//#region src/terrain/knobCatalogue.d.ts
+/**
+ * Every terrain knob with its kind, description, range and, where one value holds everywhere, its
+ * default. Static data, readable with no map loaded.
+ *
+ * @remarks
+ * A knob is a plain display value in {@link TerrainModuleConfig}, at the path its id names. Not
+ * knobs: `events`.
+ *
+ * @group Terrain
+ */
+export declare const terrainKnobCatalogue: readonly TerrainKnob[];
+/**
+ * Every terrain knob id, in catalogue order.
+ *
+ * @group Terrain
+ */
+export declare const terrainKnobIds: readonly TerrainKnobId[];
+//#endregion
 //#region src/terrain/TerrainModule.d.ts
 /**
  * The style source this module draws from: the raster-dem elevation source of the hillshade
@@ -12401,6 +13161,7 @@ type TerrainSourcesWithLayers = {
  * **What this module owns:** whether the hillshade is shown, and whether and how high the surface is raised.
  * Shading method, light direction, strength, zoom range and colours are `hillshade.*` {@link StylingModule} knobs.
  * See [Who owns what](https://docs.tomtom.com/maps-sdk-js/guides/map/modules#who-owns-what).
+ * {@link terrainKnobCatalogue} lists every setting of its configuration.
  *
  * - **Hillshade** shades slopes on the flat map, so the relief reads at any pitch.
  * - **Elevation** raises the map surface in 3D, which a pitched camera shows. Combined with the
@@ -12453,7 +13214,9 @@ export declare class TerrainModule extends AbstractStyleOwnedMapModule<TerrainSo
    */
   setHillshadeVisible(visible: boolean): void;
   /**
-   * Whether the hillshade shading is shown.
+   * Whether the hillshade shading is set to be shown.
+   *
+   * @returns The `hillshade` setting; `false` while nothing has set it, as the hillshade is hidden until shown.
    */
   isHillshadeVisible(): boolean;
   /**
@@ -12461,7 +13224,9 @@ export declare class TerrainModule extends AbstractStyleOwnedMapModule<TerrainSo
    */
   setElevationEnabled(enabled: boolean): void;
   /**
-   * Whether the map surface is raised in 3D.
+   * Whether the map surface is set to be raised in 3D.
+   *
+   * @returns The `elevation` setting; while nothing has set it, whether the map's own terrain raises it.
    */
   isElevationEnabled(): boolean;
   /**
@@ -12957,6 +13722,636 @@ type TrafficAreaAnalyticsModuleConfig = MapModuleCommonConfig & {
   regionPolygon?: AreaAnalyticsRegionPolygonConfig;
 };
 //#endregion
+//#region src/traffic/types/trafficCommonConfig.d.ts
+/**
+ * Available road hierarchy category identifiers.
+ *
+ * @remarks
+ * These categories represent different levels in the road network hierarchy,
+ * from major highways to local streets.
+ *
+ * @group Traffic
+ */
+export declare const roadCategories: readonly ["motorway", "motorway_link", "trunk", "trunk_link", "primary", "primary_link", "secondary", "secondary_link", "tertiary", "tertiary_link", "street", "service", "track"];
+/**
+ * Road hierarchy category type.
+ *
+ * @remarks
+ * Classifies roads by their importance and capacity in the transportation network.
+ * Used for filtering traffic data display based on road significance.
+ *
+ * Road hierarchy (from highest to lowest):
+ * - `motorway` / `motorway_link` - High-capacity highways with restricted access
+ * - `trunk` / `trunk_link` - Major inter-city roads
+ * - `primary` / `primary_link` - Primary through routes
+ * - `secondary` / `secondary_link` - Secondary through routes
+ * - `tertiary` / `tertiary_link` - Connecting roads
+ * - `street` - Local streets (see {@link StreetRoadSubCategory})
+ * - `service` - Service roads (see {@link ServiceRoadSubCategory})
+ * - `track` - Unpaved or agricultural tracks
+ *
+ * @group Traffic
+ */
+export type RoadCategory = (typeof roadCategories)[number];
+/**
+ * Available street road sub-category identifiers.
+ *
+ * @remarks
+ * Provides finer granularity for classifying local streets.
+ *
+ * @group Traffic
+ */
+export declare const streetRoadSubCategories: readonly ["unclassified", "residential", "living_street"];
+/**
+ * Street road sub-category type.
+ *
+ * @remarks
+ * Further classifies `street` roads into specific sub-types.
+ *
+ * Sub-categories:
+ * - `unclassified` - Unclassified local roads
+ * - `residential` - Roads in residential areas
+ * - `living_street` - Pedestrian-priority shared streets
+ *
+ * @group Traffic
+ */
+export type StreetRoadSubCategory = (typeof streetRoadSubCategories)[number];
+/**
+ * Available service road sub-category identifiers.
+ *
+ * @remarks
+ * Provides finer granularity for classifying service roads.
+ *
+ * @group Traffic
+ */
+export declare const serviceRoadSubCategories: readonly ["parking", "driveway", "alley"];
+/**
+ * Service road sub-category type.
+ *
+ * @remarks
+ * Further classifies `service` roads into specific sub-types.
+ *
+ * Sub-categories:
+ * - `parking` - Roads within parking areas
+ * - `driveway` - Private access roads
+ * - `alley` - Narrow back-access lanes
+ *
+ * @group Traffic
+ */
+export type ServiceRoadSubCategory = (typeof serviceRoadSubCategories)[number];
+/**
+ * Road sub-category type.
+ *
+ * @remarks
+ * Combines street and service sub-categories. Only `street` and `service` road categories have sub-categories.
+ *
+ * @group Traffic
+ */
+export type RoadSubCategory = StreetRoadSubCategory | ServiceRoadSubCategory;
+/**
+ * Common filter configuration shared between traffic incidents and flow visualization.
+ *
+ * @remarks
+ * Provides road category filtering capabilities used by both incident and flow modules.
+ *
+ * @group Traffic
+ */
+export type TrafficCommonFilter = {
+  /**
+   * Filters traffic data by road hierarchy categories.
+   *
+   * @remarks
+   * Controls which road types display traffic information.
+   * Use the `mode` field to specify whether to show or hide the selected categories.
+   *
+   * @example
+   * ```ts
+   * // Show only motorways and trunk roads
+   * roadCategories: { show: 'only', values: ['motorway', 'trunk'] }
+   * ```
+   */
+  roadCategories?: ValuesFilter<RoadCategory>;
+  /**
+   * Filters traffic data by road sub-categories.
+   *
+   * @remarks
+   * Provides finer-grained control for street and service roads.
+   * Applies to sub-categories of {@link StreetRoadSubCategory} and {@link ServiceRoadSubCategory}.
+   *
+   * @example
+   * ```ts
+   * // Hide minor local streets
+   * roadSubCategories: { show: 'all-except', values: ['living_street'] }
+   * ```
+   */
+  roadSubCategories?: ValuesFilter<RoadSubCategory>;
+};
+//#endregion
+//#region src/traffic/types/trafficFlowConfig.d.ts
+/**
+ * Filter configuration for traffic flow visualization.
+ *
+ * @remarks
+ * Extends common traffic filters with flow-specific options,
+ * particularly for highlighting road closures in the flow layer.
+ *
+ * @group Traffic Flow
+ */
+export type TrafficFlowFilter = TrafficCommonFilter & {
+  /**
+   * Controls road closure display in the traffic flow layer.
+   *
+   * @remarks
+   * Determines whether to exclusively show road closures or exclude them from display.
+   *
+   * - `'only'` - Display only road closures
+   * - `'all-except'` - Display everything except road closures
+   *
+   * @example
+   * ```ts
+   * // Highlight only road closures
+   * showRoadClosures: 'only'
+   * ```
+   */
+  showRoadClosures?: FilterShowMode;
+};
+/**
+ * Collection of traffic flow filters with OR logic.
+ *
+ * @remarks
+ * Combines multiple flow filter configurations where traffic flow data is shown
+ * if it matches **any** of the provided filter criteria (logical OR).
+ *
+ * @example
+ * ```ts
+ * // Show flow on motorways OR show road closures on any road
+ * filters: {
+ *   any: [
+ *     { roadCategories: { show: 'only', values: ['motorway'] } },
+ *     { showRoadClosures: 'only' }
+ *   ]
+ * }
+ * ```
+ *
+ * @group Traffic Flow
+ */
+export type TrafficFlowFilters = {
+  /**
+   * Array of flow filters combined with OR logic.
+   *
+   * @remarks
+   * Traffic flow data is displayed if it satisfies at least one of the filter configurations.
+   */
+  any: TrafficFlowFilter[];
+};
+/**
+ * Configuration for traffic flow visualization module.
+ *
+ * @remarks
+ * Controls the display of real-time traffic flow data on road segments,
+ * including styling and filtering options.
+ *
+ * @group Traffic Flow
+ */
+export type TrafficFlowModuleConfig = MapModuleCommonConfig & {
+  /**
+   * Controls the visibility of the traffic flow layers.
+   *
+   * @default false
+   */
+  visible?: boolean;
+  /**
+   * Filter configuration for traffic flow data.
+   *
+   * @remarks
+   * Controls which road segments display traffic flow information
+   * based on road category and closure status.
+   */
+  filters?: TrafficFlowFilters;
+};
+//#endregion
+//#region src/traffic/types/trafficIncidentOverlayConfig.d.ts
+/**
+ * The values {@link IncidentFocusStyle.widthFactor} is clamped to.
+ *
+ * @remarks
+ * `1` leaves focused incidents at their normal width; above `1.8` the widened stripe would cover
+ * the focus outline at high zoom.
+ * @group Traffic
+ */
+export declare const INCIDENT_FOCUS_WIDTH_FACTOR_RANGE: KnobRange;
+/**
+ * Visual treatment applied to the focused subset by
+ * {@link TrafficIncidentOverlayModule.setFocus}.
+ *
+ * @group Traffic
+ */
+export type IncidentFocusStyle = {
+  /**
+   * Colour of the outline painted beneath the focused stripe.
+   *
+   * @defaultValue `#000` on light map styles, `#FFF` on dark styles
+   */
+  outlineColor?: string;
+  /**
+   * Multiplier applied to the line width of focused features, clamped to
+   * {@link INCIDENT_FOCUS_WIDTH_FACTOR_RANGE} (`1`–`1.8`); a value that is not a finite number
+   * falls back to the default. `1` disables the width pop while keeping the outline.
+   *
+   * @defaultValue `1.6`
+   */
+  widthFactor?: number;
+};
+/**
+ * Configuration for {@link TrafficIncidentOverlayModule}.
+ *
+ * @group Traffic
+ */
+export type TrafficIncidentOverlayModuleConfig = MapModuleCommonConfig & {
+  /**
+   * Whether the incident layers are shown. Defaults to `true`.
+   * `show()` never flips this flag — if `false`, the module loads data but
+   * keeps layers hidden until `setVisible(true)` is called.
+   */
+  visible?: boolean;
+  /**
+   * Position incident layers before this map-style layer. Pass `'top'` to
+   * pin them above every other layer. Defaults to `'lowestLabel'`, which
+   * keeps incidents below map labels (roads, places, POIs) so labels stay
+   * readable — the same default the routing module and the flat area
+   * analytics layers use.
+   */
+  beforeLayerConfig?: BeforeLayerConfig;
+  /**
+   * Visual treatment for {@link TrafficIncidentOverlayModule.setFocus}.
+   *
+   * - Omit (or `undefined`) — use the SDK default treatment: an outline beneath
+   *   the focused stripe (black on light map styles, white on dark) and a `1.6×` width pop.
+   * - `false` — disable the visual treatment. `setFocus(ids)` still writes
+   *   MapLibre `feature-state.focused`, so callers can drive their own
+   *   styling (extra layers, sidebar overlays, …) off that state.
+   * - `{ outlineColor?, widthFactor? }` — override individual fields of the
+   *   default treatment.
+   */
+  focus?: false | IncidentFocusStyle;
+};
+//#endregion
+//#region src/traffic/types/trafficIncidentsConfig.d.ts
+/**
+ * Configuration for filtering traffic incidents by delay duration.
+ *
+ * @remarks
+ * Allows filtering incidents based on whether they cause delays and the severity of those delays.
+ * Useful for focusing on incidents with the most significant traffic impact.
+ *
+ * @group Traffic Incidents
+ */
+export type DelayFilter = {
+  /**
+   * Requires incidents to have an associated delay.
+   *
+   * @remarks
+   * When `true`, incidents without delay information will be hidden from the map.
+   * When `false` or omitted, incidents are shown regardless of delay data availability.
+   *
+   * @defaultValue `false`
+   */
+  mustHaveDelay?: boolean;
+  /**
+   * Minimum delay threshold in minutes.
+   *
+   * @remarks
+   * Only incidents causing delays of at least this duration will be shown.
+   *
+   * **Behavior:**
+   * - If `mustHaveDelay` is `false` or not set, this filter only applies to incidents that have delay data
+   * - Incidents without delay data are still shown (unless `mustHaveDelay` is `true`)
+   *
+   * @example
+   * ```ts
+   * // Show only incidents with delays of 5 minutes or more
+   * delays: { minDelayMinutes: 5 }
+   * ```
+   */
+  minDelayMinutes?: number;
+};
+/**
+ * Filter configuration for traffic incidents visualization.
+ *
+ * @remarks
+ * Extends common traffic filters with incident-specific filtering options
+ * including category, severity, and delay-based filtering.
+ *
+ * @group Traffic Incidents
+ */
+export type TrafficIncidentsFilter = TrafficCommonFilter & {
+  /**
+   * Filters incidents by category type.
+   *
+   * @remarks
+   * Controls which types of incidents are displayed on the map.
+   *
+   * @example
+   * ```ts
+   * // Show only accidents and road closures
+   * incidentCategories: { show: 'only', values: ['accident', 'road-closed'] }
+   * ```
+   */
+  incidentCategories?: ValuesFilter<TrafficIncidentCategory>;
+  /**
+   * Filters incidents by delay severity magnitude.
+   *
+   * @remarks
+   * Controls display based on the severity of traffic delays caused by incidents.
+   *
+   * Available magnitude values:
+   * - `'unknown'` - Unknown delay severity
+   * - `'minor'` - Minor delays
+   * - `'moderate'` - Moderate delays
+   * - `'major'` - Major delays
+   * - `'indefinite'` - Indefinite delays (e.g., road closures)
+   *
+   * @example
+   * ```ts
+   * // Show only major incidents
+   * magnitudes: { show: 'only', values: ['major'] }
+   *
+   * // Show moderate and major incidents
+   * magnitudes: { show: 'only', values: ['moderate', 'major'] }
+   *
+   * // Hide minor incidents
+   * magnitudes: { show: 'all-except', values: ['minor'] }
+   * ```
+   */
+  magnitudes?: ValuesFilter<DelayMagnitude>;
+  /**
+   * Filters incidents by delay duration.
+   *
+   * @remarks
+   * Allows filtering based on whether incidents have delays and minimum delay thresholds.
+   */
+  delays?: DelayFilter;
+};
+/**
+ * Collection of traffic incident filters with OR logic.
+ *
+ * @remarks
+ * Combines multiple incident filter configurations where an incident is shown
+ * if it matches **any** of the provided filter criteria (logical OR).
+ *
+ * This allows for complex filtering scenarios where incidents from different
+ * categories or with different characteristics can all be displayed.
+ *
+ * @example
+ * ```ts
+ * // Show major incidents OR road closures
+ * filters: {
+ *   any: [
+ *     { magnitudes: { show: 'only', values: ['major'] } },
+ *     { incidentCategories: { show: 'only', values: ['road-closed'] } }
+ *   ]
+ * }
+ * ```
+ *
+ * @group Traffic Incidents
+ */
+export type TrafficIncidentsFilters = {
+  /**
+   * Array of incident filters combined with OR logic.
+   *
+   * @remarks
+   * An incident is displayed if it satisfies at least one of the filter configurations.
+   */
+  any: TrafficIncidentsFilter[];
+};
+/**
+ * Configuration for the incident icons.
+ *
+ * @group Traffic Incidents
+ */
+export type IncidentIconsConfig = {
+  /**
+   * Shows or hides the incident icons, independently of the incident lines.
+   *
+   * @remarks
+   * When omitted, the icons follow the module's `visible`.
+   */
+  visible?: boolean;
+};
+/**
+ * Configuration for traffic incidents module.
+ *
+ * @remarks
+ * One set of `filters` narrows both the incident lines and their icons; `icons` only decides whether
+ * the icons are shown.
+ *
+ * @group Traffic Incidents
+ */
+export type TrafficIncidentsModuleConfig = MapModuleCommonConfig & {
+  /**
+   * Controls the visibility of the traffic incident layers, icons included.
+   *
+   * @default false
+   */
+  visible?: boolean;
+  /**
+   * Which incidents are shown, by category, severity, delay and road type — lines and icons alike.
+   */
+  filters?: TrafficIncidentsFilters;
+  /**
+   * Configuration specific to the incident icons.
+   */
+  icons?: IncidentIconsConfig;
+};
+//#endregion
+//#region src/traffic/types/trafficKnobs.d.ts
+type TrafficKnobKind = Exclude<KnobKind, 'offset' | 'colors' | 'text'>;
+type ValuesFilterKnobPath<KEY extends string> = `${KEY}.${keyof ValuesFilter<unknown>}`;
+type KeyOfEither<T> = T extends unknown ? keyof T : never;
+/**
+ * The id of a traffic flow knob: its path into {@link TrafficFlowModuleConfig}, e.g. `visible` or
+ * `filters.any.0.roadCategories.values`. See {@link trafficFlowKnobCatalogue} for what each one does.
+ *
+ * @remarks
+ * The filter knobs set the first of the `filters.any` alternatives.
+ *
+ * @group Traffic Flow
+ */
+type TrafficFlowKnobId = 'visible' | `filters.any.0.${ValuesFilterKnobPath<Exclude<keyof TrafficFlowFilter, 'showRoadClosures'>>}` | 'filters.any.0.showRoadClosures';
+/**
+ * The value type a given traffic flow knob takes: the plain value its path holds in
+ * {@link TrafficFlowModuleConfig}.
+ *
+ * @group Traffic Flow
+ */
+type TrafficFlowKnobValueOf<ID extends TrafficFlowKnobId> = KnobPlainValue<ValueAt<TrafficFlowModuleConfig, ID>>;
+/**
+ * One entry of {@link trafficFlowKnobCatalogue}. The value in force is the one at its path in
+ * {@link TrafficFlowModule.getConfig}, else its `default`.
+ *
+ * @group Traffic Flow
+ */
+type TrafficFlowKnob = KnobEntry<TrafficFlowKnobId, TrafficKnobKind>;
+/**
+ * The id of a traffic incidents knob: its path into {@link TrafficIncidentsModuleConfig}, e.g.
+ * `icons.visible` or `filters.any.0.magnitudes.values`. See {@link trafficIncidentsKnobCatalogue}
+ * for what each one does.
+ *
+ * @remarks
+ * The filter knobs set the first of the `filters.any` alternatives.
+ *
+ * @group Traffic Incidents
+ */
+type TrafficIncidentsKnobId = 'visible' | `icons.${keyof IncidentIconsConfig}` | `filters.any.0.${ValuesFilterKnobPath<Exclude<keyof TrafficIncidentsFilter, 'delays'>>}` | `filters.any.0.delays.${keyof DelayFilter}`;
+/**
+ * The value type a given traffic incidents knob takes: the plain value its path holds in
+ * {@link TrafficIncidentsModuleConfig}.
+ *
+ * @group Traffic Incidents
+ */
+type TrafficIncidentsKnobValueOf<ID extends TrafficIncidentsKnobId> = KnobPlainValue<ValueAt<TrafficIncidentsModuleConfig, ID>>;
+/**
+ * One entry of {@link trafficIncidentsKnobCatalogue}. The value in force is the one at its path in
+ * {@link TrafficIncidentsModule.getConfig}, else its `default`; with neither, the entry says what
+ * it follows.
+ *
+ * @group Traffic Incidents
+ */
+type TrafficIncidentsKnob = KnobEntry<TrafficIncidentsKnobId, TrafficKnobKind>;
+/**
+ * The id of an incident overlay knob: its path into {@link TrafficIncidentOverlayModuleConfig}.
+ * See {@link trafficIncidentOverlayKnobCatalogue} for what each one does.
+ *
+ * @group Traffic
+ */
+type TrafficIncidentOverlayKnobId = 'visible' | `focus.${keyof IncidentFocusStyle}`;
+/**
+ * The value type a given incident overlay knob takes: the plain value its path holds in
+ * {@link TrafficIncidentOverlayModuleConfig}.
+ *
+ * @group Traffic
+ */
+type TrafficIncidentOverlayKnobValueOf<ID extends TrafficIncidentOverlayKnobId> = KnobPlainValue<ValueAt<TrafficIncidentOverlayModuleConfig, ID>>;
+/**
+ * One entry of {@link trafficIncidentOverlayKnobCatalogue}. The value in force is the one at its
+ * path in {@link TrafficIncidentOverlayModule.getConfig}, else its `default`; with neither, the
+ * map's light/dark theme decides.
+ *
+ * @group Traffic
+ */
+type TrafficIncidentOverlayKnob = KnobEntry<TrafficIncidentOverlayKnobId, TrafficKnobKind>;
+/**
+ * An area analytics knob's path below `metricConfig.<metric>.`, whichever metric takes it.
+ * @ignore
+ */
+type AreaAnalyticsMetricKnobLeaf = 'color' | `height.${KeyOfEither<AreaAnalyticsHeightConfig>}` | `filters.${keyof AreaAnalyticsMetricFilter}`;
+/**
+ * The id of an area analytics knob: its path into {@link TrafficAreaAnalyticsModuleConfig}, e.g.
+ * `displayMode` or `metricConfig.speed.color`. See {@link trafficAreaAnalyticsKnobCatalogue} for
+ * what each one does.
+ *
+ * @remarks
+ * Every metric of {@link AreaAnalyticsMetricKey} takes the same knobs below `metricConfig.<metric>.`.
+ *
+ * @group Traffic Area Analytics
+ */
+type TrafficAreaAnalyticsKnobId = 'visible' | 'displayMode' | 'activeMetric' | `regionPolygon.${keyof AreaAnalyticsRegionPolygonConfig}` | `metricConfig.${AreaAnalyticsMetricKey}.${AreaAnalyticsMetricKnobLeaf}`;
+/**
+ * The value type a given area analytics knob takes: the plain value its path holds in
+ * {@link TrafficAreaAnalyticsModuleConfig}.
+ *
+ * @remarks
+ * `metricConfig.<metric>.color` is a theme name: the custom colour stops the config also takes there
+ * are not a knob value.
+ *
+ * @group Traffic Area Analytics
+ */
+type TrafficAreaAnalyticsKnobValueOf<ID extends TrafficAreaAnalyticsKnobId> = KnobPlainValue<ValueAt<TrafficAreaAnalyticsModuleConfig, ID>>;
+/**
+ * One entry of {@link trafficAreaAnalyticsKnobCatalogue}. The value in force is the one at its path
+ * in {@link TrafficAreaAnalyticsModule.getConfig}, else its `default`; with neither, the entry says
+ * what decides.
+ *
+ * @group Traffic Area Analytics
+ */
+type TrafficAreaAnalyticsKnob = KnobEntry<TrafficAreaAnalyticsKnobId, TrafficKnobKind>;
+//#endregion
+//#region src/traffic/knobCatalogue.d.ts
+/**
+ * Every {@link TrafficFlowModule} knob with its kind, description and default. Static data,
+ * readable with no map loaded.
+ *
+ * @remarks
+ * The module owns whether flow is shown and which roads show it; the look of the flow lines is
+ * `StylingModule`'s `traffic.flow.*` knobs. The `filters.any.0.*` knobs set the first of the
+ * `filters.any` alternatives; the further ones a road may match instead are config only, and so
+ * are `events`.
+ *
+ * @group Traffic Flow
+ */
+export declare const trafficFlowKnobCatalogue: readonly TrafficFlowKnob[];
+/**
+ * Every traffic flow knob id, in catalogue order.
+ *
+ * @group Traffic Flow
+ */
+export declare const trafficFlowKnobIds: readonly TrafficFlowKnobId[];
+/**
+ * Every {@link TrafficIncidentsModule} knob with its kind, description and, where one value holds
+ * everywhere, its default. Static data, readable with no map loaded.
+ *
+ * @remarks
+ * The module owns whether incidents are shown and which; their look is `StylingModule`'s
+ * `traffic.incidents.*` knobs. The `filters.any.0.*` knobs set the first of the `filters.any`
+ * alternatives; the further ones an incident may match instead are config only, and so are
+ * `events`.
+ *
+ * @group Traffic Incidents
+ */
+export declare const trafficIncidentsKnobCatalogue: readonly TrafficIncidentsKnob[];
+/**
+ * Every traffic incidents knob id, in catalogue order.
+ *
+ * @group Traffic Incidents
+ */
+export declare const trafficIncidentsKnobIds: readonly TrafficIncidentsKnobId[];
+/**
+ * Every {@link TrafficIncidentOverlayModule} knob with its kind, description, range and, where one
+ * value holds everywhere, its default. Static data, readable with no map loaded.
+ *
+ * @remarks
+ * The incident lines take the colours of the style's own incident layers, which are
+ * `StylingModule`'s `traffic.incidents.*` knobs. Not knobs: `beforeLayerConfig`, `focus: false`,
+ * which turns the focus treatment off, and `events`.
+ *
+ * @group Traffic
+ */
+export declare const trafficIncidentOverlayKnobCatalogue: readonly TrafficIncidentOverlayKnob[];
+/**
+ * Every incident overlay knob id, in catalogue order.
+ *
+ * @group Traffic
+ */
+export declare const trafficIncidentOverlayKnobIds: readonly TrafficIncidentOverlayKnobId[];
+/**
+ * Every {@link TrafficAreaAnalyticsModule} knob with its kind, description, range or options and,
+ * where one value holds everywhere, its default: the module-wide knobs first, then each metric's.
+ * Static data, readable with no map loaded.
+ *
+ * @remarks
+ * Not knobs: custom colour stops, `beforeLayerConfig` and `events`, which take structured values.
+ * The module bounds no height: a height knob's range is the span a UI offers.
+ *
+ * @group Traffic Area Analytics
+ */
+export declare const trafficAreaAnalyticsKnobCatalogue: readonly TrafficAreaAnalyticsKnob[];
+/**
+ * Every area analytics knob id, in catalogue order.
+ *
+ * @group Traffic Area Analytics
+ */
+export declare const trafficAreaAnalyticsKnobIds: readonly TrafficAreaAnalyticsKnobId[];
+//#endregion
 //#region src/traffic/layers/areaAnalyticsLayers.d.ts
 /**
  * Resolves the effective color stops for a given color configuration.
@@ -13055,6 +14450,8 @@ export declare class TrafficAreaAnalyticsModule extends AbstractDataOwnedMapModu
    * instance. Every call therefore returns a **new, independent** instance, and stacking several
    * of them on one map is a supported thing to do.
    *
+   * {@link trafficAreaAnalyticsKnobCatalogue} lists the plain-valued settings of `config` as data.
+   *
    * @param tomtomMap - The TomTomMap instance.
    * @param config - Optional initial configuration. Omit to use all defaults.
    * @returns A promise that resolves with the initialised module.
@@ -13196,15 +14593,6 @@ export declare class TrafficAreaAnalyticsModule extends AbstractDataOwnedMapModu
    * @param metrics - Optional list of metrics to clear. When omitted, clears filters for **all** metrics.
    */
   clearFilter(metrics?: AreaAnalyticsMetricKey[]): void;
-  /**
-   * Shows or hides all area analytics layers.
-   */
-  setVisible(visible: boolean): void;
-  /**
-   * Whether the module is set to be shown ({@link TrafficAreaAnalyticsModuleConfig.visible}). A shown
-   * module with no data draws nothing; {@link getShown} holds what is shown.
-   */
-  isVisible(): boolean;
   /**
    * Returns the currently displayed data for all visualisation modes.
    */
@@ -13246,224 +14634,17 @@ export declare class TrafficAreaAnalyticsModule extends AbstractDataOwnedMapModu
   get events(): CombinedEvents<AreaAnalyticsTileFeature, TrafficAreaAnalyticsModuleConfig, TrafficAreaAnalytics>;
   private get mode();
   private get activeMetric();
-  private get lightDark();
-  private applyModeVisibility;
-  private hideAllDataLayers;
-  private addHighlightLayersToMap;
-  private setHighlightLayerVisible;
-  private applyLayerConfig;
-  private applyRegionConfig;
-  private applyFiltersToLayers;
-  private buildRegionFC;
-}
-//#endregion
-//#region src/traffic/types/trafficCommonConfig.d.ts
-/**
- * Available road hierarchy category identifiers.
- *
- * @remarks
- * These categories represent different levels in the road network hierarchy,
- * from major highways to local streets.
- *
- * @group Traffic
- */
-export declare const roadCategories: readonly ["motorway", "motorway_link", "trunk", "trunk_link", "primary", "primary_link", "secondary", "secondary_link", "tertiary", "tertiary_link", "street", "service", "track"];
-/**
- * Road hierarchy category type.
- *
- * @remarks
- * Classifies roads by their importance and capacity in the transportation network.
- * Used for filtering traffic data display based on road significance.
- *
- * Road hierarchy (from highest to lowest):
- * - `motorway` / `motorway_link` - High-capacity highways with restricted access
- * - `trunk` / `trunk_link` - Major inter-city roads
- * - `primary` / `primary_link` - Primary through routes
- * - `secondary` / `secondary_link` - Secondary through routes
- * - `tertiary` / `tertiary_link` - Connecting roads
- * - `street` - Local streets (see {@link StreetRoadSubCategory})
- * - `service` - Service roads (see {@link ServiceRoadSubCategory})
- * - `track` - Unpaved or agricultural tracks
- *
- * @group Traffic
- */
-export type RoadCategory = (typeof roadCategories)[number];
-/**
- * Available street road sub-category identifiers.
- *
- * @remarks
- * Provides finer granularity for classifying local streets.
- *
- * @group Traffic
- */
-export declare const streetRoadSubCategories: readonly ["unclassified", "residential", "living_street"];
-/**
- * Street road sub-category type.
- *
- * @remarks
- * Further classifies `street` roads into specific sub-types.
- *
- * Sub-categories:
- * - `unclassified` - Unclassified local roads
- * - `residential` - Roads in residential areas
- * - `living_street` - Pedestrian-priority shared streets
- *
- * @group Traffic
- */
-export type StreetRoadSubCategory = (typeof streetRoadSubCategories)[number];
-/**
- * Available service road sub-category identifiers.
- *
- * @remarks
- * Provides finer granularity for classifying service roads.
- *
- * @group Traffic
- */
-export declare const serviceRoadSubCategories: readonly ["parking", "driveway", "alley"];
-/**
- * Service road sub-category type.
- *
- * @remarks
- * Further classifies `service` roads into specific sub-types.
- *
- * Sub-categories:
- * - `parking` - Roads within parking areas
- * - `driveway` - Private access roads
- * - `alley` - Narrow back-access lanes
- *
- * @group Traffic
- */
-export type ServiceRoadSubCategory = (typeof serviceRoadSubCategories)[number];
-/**
- * Road sub-category type.
- *
- * @remarks
- * Combines street and service sub-categories. Only `street` and `service` road categories have sub-categories.
- *
- * @group Traffic
- */
-export type RoadSubCategory = StreetRoadSubCategory | ServiceRoadSubCategory;
-/**
- * Common filter configuration shared between traffic incidents and flow visualization.
- *
- * @remarks
- * Provides road category filtering capabilities used by both incident and flow modules.
- *
- * @group Traffic
- */
-export type TrafficCommonFilter = {
-  /**
-   * Filters traffic data by road hierarchy categories.
-   *
-   * @remarks
-   * Controls which road types display traffic information.
-   * Use the `mode` field to specify whether to show or hide the selected categories.
-   *
-   * @example
-   * ```ts
-   * // Show only motorways and trunk roads
-   * roadCategories: { show: 'only', values: ['motorway', 'trunk'] }
-   * ```
-   */
-  roadCategories?: ValuesFilter<RoadCategory>;
-  /**
-   * Filters traffic data by road sub-categories.
-   *
-   * @remarks
-   * Provides finer-grained control for street and service roads.
-   * Applies to sub-categories of {@link StreetRoadSubCategory} and {@link ServiceRoadSubCategory}.
-   *
-   * @example
-   * ```ts
-   * // Hide minor local streets
-   * roadSubCategories: { show: 'all-except', values: ['living_street'] }
-   * ```
-   */
-  roadSubCategories?: ValuesFilter<RoadSubCategory>;
-};
-//#endregion
-//#region src/traffic/types/trafficFlowConfig.d.ts
-/**
- * Filter configuration for traffic flow visualization.
- *
- * @remarks
- * Extends common traffic filters with flow-specific options,
- * particularly for highlighting road closures in the flow layer.
- *
- * @group Traffic Flow
- */
-export type TrafficFlowFilter = TrafficCommonFilter & {
-  /**
-   * Controls road closure display in the traffic flow layer.
-   *
-   * @remarks
-   * Determines whether to exclusively show road closures or exclude them from display.
-   *
-   * - `'show'` - Display only road closures
-   * - `'hide'` - Display everything except road closures
-   *
-   * @example
-   * ```ts
-   * // Highlight only road closures
-   * showRoadClosures: 'show'
-   * ```
-   */
-  showRoadClosures?: FilterShowMode;
-};
-/**
- * Collection of traffic flow filters with OR logic.
- *
- * @remarks
- * Combines multiple flow filter configurations where traffic flow data is shown
- * if it matches **any** of the provided filter criteria (logical OR).
- *
- * @example
- * ```ts
- * // Show flow on motorways OR show road closures on any road
- * filters: {
- *   any: [
- *     { roadCategories: { show: 'only', values: ['motorway'] } },
- *     { showRoadClosures: 'only' }
- *   ]
- * }
- * ```
- *
- * @group Traffic Flow
- */
-export type TrafficFlowFilters = {
-  /**
-   * Array of flow filters combined with OR logic.
-   *
-   * @remarks
-   * Traffic flow data is displayed if it satisfies at least one of the filter configurations.
-   */
-  any: TrafficFlowFilter[];
-};
-/**
- * Configuration for traffic flow visualization module.
- *
- * @remarks
- * Controls the display of real-time traffic flow data on road segments,
- * including styling and filtering options.
- *
- * @group Traffic Flow
- */
-export type TrafficFlowModuleConfig = MapModuleCommonConfig & {
-  /**
-   * Controls the visibility of the traffic flow layers.
-   *
-   * @default false
-   */
-  visible?: boolean;
-  /**
-   * Filter configuration for traffic flow data.
-   *
-   * @remarks
-   * Controls which road segments display traffic flow information
-   * based on road category and closure status.
-   */
-  filters?: TrafficFlowFilters;
-};
+  private get lightDark();
+  /** @ignore */
+  protected applyVisibility(config: TrafficAreaAnalyticsModuleConfig | undefined): void;
+  private hideAllDataLayers;
+  private addHighlightLayersToMap;
+  private setHighlightLayerVisible;
+  private applyLayerConfig;
+  private applyRegionConfig;
+  private applyFiltersToLayers;
+  private buildRegionFC;
+}
 //#endregion
 //#region src/traffic/types/trafficFlowFeature.d.ts
 /**
@@ -13617,6 +14798,8 @@ export declare class TrafficFlowModule extends AbstractStyleOwnedMapModule<Traff
    * - `ensureAddedToStyle`: Auto-add traffic flow to style if missing
    * - `filters`: Road category and type filters
    *
+   * {@link trafficFlowKnobCatalogue} lists the plain-valued settings as data.
+   *
    * **Style Requirement:**
    * Traffic flow must be included in the map style or added via `ensureAddedToStyle`.
    *
@@ -13749,7 +14932,9 @@ export declare class TrafficFlowModule extends AbstractStyleOwnedMapModule<Traff
   setVisible(visible: boolean): void;
   private _setVisible;
   /**
-   * Returns if any layer for traffic flow is visible or not.
+   * Whether traffic flow is set to be shown.
+   *
+   * @returns The `visible` setting; `false` while nothing has set it, as traffic is hidden until shown.
    */
   isVisible(): boolean;
   /**
@@ -13787,72 +14972,6 @@ export declare class TrafficFlowModule extends AbstractStyleOwnedMapModule<Traff
   get events(): CombinedEvents<TrafficFlowModuleFeature, TrafficFlowModuleConfig, never>;
 }
 //#endregion
-//#region src/traffic/types/trafficIncidentOverlayConfig.d.ts
-/**
- * The values {@link IncidentFocusStyle.widthFactor} is clamped to.
- *
- * @remarks
- * `1` leaves focused incidents at their normal width; above `1.8` the widened stripe would cover
- * the focus outline at high zoom.
- * @group Traffic
- */
-export declare const INCIDENT_FOCUS_WIDTH_FACTOR_RANGE: KnobRange;
-/**
- * Visual treatment applied to the focused subset by
- * {@link TrafficIncidentOverlayModule.setFocus}.
- *
- * @group Traffic
- */
-export type IncidentFocusStyle = {
-  /**
-   * Colour of the outline painted beneath the focused stripe.
-   *
-   * @defaultValue `#000` on light map styles, `#FFF` on dark styles
-   */
-  outlineColor?: string;
-  /**
-   * Multiplier applied to the line width of focused features, clamped to
-   * {@link INCIDENT_FOCUS_WIDTH_FACTOR_RANGE} (`1`–`1.8`); a value that is not a finite number
-   * falls back to the default. `1` disables the width pop while keeping the outline.
-   *
-   * @defaultValue `1.6`
-   */
-  widthFactor?: number;
-};
-/**
- * Configuration for {@link TrafficIncidentOverlayModule}.
- *
- * @group Traffic
- */
-export type TrafficIncidentOverlayModuleConfig = MapModuleCommonConfig & {
-  /**
-   * Whether the incident layers are shown. Defaults to `true`.
-   * `show()` never flips this flag — if `false`, the module loads data but
-   * keeps layers hidden until `setVisible(true)` is called.
-   */
-  visible?: boolean;
-  /**
-   * Position incident layers before this map-style layer. Pass `'top'` to
-   * pin them above every other layer. Defaults to `'lowestLabel'`, which
-   * keeps incidents below map labels (roads, places, POIs) so labels stay
-   * readable — the same default the routing module and the flat area
-   * analytics layers use.
-   */
-  beforeLayerConfig?: BeforeLayerConfig;
-  /**
-   * Visual treatment for {@link TrafficIncidentOverlayModule.setFocus}.
-   *
-   * - Omit (or `undefined`) — use the SDK default treatment: an outline beneath
-   *   the focused stripe (black on light map styles, white on dark) and a `1.6×` width pop.
-   * - `false` — disable the visual treatment. `setFocus(ids)` still writes
-   *   MapLibre `feature-state.focused`, so callers can drive their own
-   *   styling (extra layers, sidebar overlays, …) off that state.
-   * - `{ outlineColor?, widthFactor? }` — override individual fields of the
-   *   default treatment.
-   */
-  focus?: false | IncidentFocusStyle;
-};
-//#endregion
 //#region src/traffic/TrafficIncidentOverlayModule.d.ts
 type Sources = {
   incidents: GeoJSONSourceWithLayers<TrafficIncidentDetails>;
@@ -13871,9 +14990,10 @@ type Sources = {
  * 7–8 layers — 4 to 5 line (optional focus-halo, outline, solid inner, direction chevron,
  * pattern inner) and 3 symbol (incident marker, jam marker with delay text, closed-road
  * marker). Per-magnitude styling uses match expressions on `magnitudeOfDelay` inside a
- * single layer instead of one layer per magnitude. Colours are read from the loaded style
- * at init (see {@link ./util/readIncidentPalette}), falling back to built-in defaults when
- * absent. Direction is rendered as a tiled `line-pattern` (chevron sprite registered at
+ * single layer instead of one layer per magnitude. Colours are read from the loaded style's
+ * incident layers (see {@link ./util/readIncidentPalette}), falling back to built-in defaults
+ * when absent, and read again whenever a `traffic.incidents.*Color` styling knob recolours
+ * them. Direction is rendered as a tiled `line-pattern` (chevron sprite registered at
  * init) instead of the vector-tile module's per-feature `roads-arrow` symbol — the
  * pattern is continuous, so it reads on short jams and at planning zooms (z12+) where
  * the per-feature symbol only activates at z15+.
@@ -13962,16 +15082,22 @@ export declare class TrafficIncidentOverlayModule extends AbstractDataOwnedMapMo
    * instance. Every call therefore returns a **new, independent** instance, and stacking several
    * of them on one map is a supported thing to do.
    *
+   * {@link trafficIncidentOverlayKnobCatalogue} lists the plain-valued settings of `config` as data.
+   *
    * @param tomtomMap The TomTomMap instance.
    * @param config The module optional configuration.
    * @returns {Promise} Returns a promise with a new instance of this module.
    */
   static create(tomtomMap: TomTomMap, config?: TrafficIncidentOverlayModuleConfig): Promise<TrafficIncidentOverlayModule>;
   private constructor();
+  private buildLayerSpecs;
+  private updateLayers;
   /** @ignore */
   protected _initSourcesWithLayers(config?: TrafficIncidentOverlayModuleConfig, _restore?: boolean): Sources;
   /** @ignore */
   protected _applyConfig(config: TrafficIncidentOverlayModuleConfig | undefined): TrafficIncidentOverlayModuleConfig | undefined;
+  /** @ignore */
+  protected applyVisibility(config: TrafficIncidentOverlayModuleConfig | undefined): void;
   private applyBeforeLayer;
   /** @ignore */
   protected discardShownData(): void;
@@ -13985,15 +15111,6 @@ export declare class TrafficIncidentOverlayModule extends AbstractDataOwnedMapMo
    * Remove all rendered incidents (source kept, data emptied).
    */
   clear(): Promise<void>;
-  /**
-   * Show or hide all incident layers.
-   */
-  setVisible(visible: boolean): void;
-  /**
-   * Whether the module is set to be shown ({@link TrafficIncidentOverlayModuleConfig.visible}). A shown
-   * module with no incidents draws nothing; {@link getShown} holds what is shown.
-   */
-  isVisible(): boolean;
   /**
    * Move incident layers before the given map-style layer, or to the top.
    */
@@ -14024,174 +15141,6 @@ export declare class TrafficIncidentOverlayModule extends AbstractDataOwnedMapMo
   private clearFeatureState;
 }
 //#endregion
-//#region src/traffic/types/trafficIncidentsConfig.d.ts
-/**
- * Configuration for filtering traffic incidents by delay duration.
- *
- * @remarks
- * Allows filtering incidents based on whether they cause delays and the severity of those delays.
- * Useful for focusing on incidents with the most significant traffic impact.
- *
- * @group Traffic Incidents
- */
-export type DelayFilter = {
-  /**
-   * Requires incidents to have an associated delay.
-   *
-   * @remarks
-   * When `true`, incidents without delay information will be hidden from the map.
-   * When `false` or omitted, incidents are shown regardless of delay data availability.
-   *
-   * @defaultValue `false`
-   */
-  mustHaveDelay?: boolean;
-  /**
-   * Minimum delay threshold in minutes.
-   *
-   * @remarks
-   * Only incidents causing delays of at least this duration will be shown.
-   *
-   * **Behavior:**
-   * - If `mustHaveDelay` is `false` or not set, this filter only applies to incidents that have delay data
-   * - Incidents without delay data are still shown (unless `mustHaveDelay` is `true`)
-   *
-   * @example
-   * ```ts
-   * // Show only incidents with delays of 5 minutes or more
-   * delays: { minDelayMinutes: 5 }
-   * ```
-   */
-  minDelayMinutes?: number;
-};
-/**
- * Filter configuration for traffic incidents visualization.
- *
- * @remarks
- * Extends common traffic filters with incident-specific filtering options
- * including category, severity, and delay-based filtering.
- *
- * @group Traffic Incidents
- */
-export type TrafficIncidentsFilter = TrafficCommonFilter & {
-  /**
-   * Filters incidents by category type.
-   *
-   * @remarks
-   * Controls which types of incidents are displayed on the map.
-   *
-   * @example
-   * ```ts
-   * // Show only accidents and road closures
-   * incidentCategories: { show: 'only', values: ['accident', 'road-closed'] }
-   * ```
-   */
-  incidentCategories?: ValuesFilter<TrafficIncidentCategory>;
-  /**
-   * Filters incidents by delay severity magnitude.
-   *
-   * @remarks
-   * Controls display based on the severity of traffic delays caused by incidents.
-   *
-   * Available magnitude values:
-   * - `'unknown'` - Unknown delay severity
-   * - `'minor'` - Minor delays
-   * - `'moderate'` - Moderate delays
-   * - `'major'` - Major delays
-   * - `'indefinite'` - Indefinite delays (e.g., road closures)
-   *
-   * @example
-   * ```ts
-   * // Show only major incidents
-   * magnitudes: { show: 'only', values: ['major'] }
-   *
-   * // Show moderate and major incidents
-   * magnitudes: { show: 'only', values: ['moderate', 'major'] }
-   *
-   * // Hide minor incidents
-   * magnitudes: { show: 'all-except', values: ['minor'] }
-   * ```
-   */
-  magnitudes?: ValuesFilter<DelayMagnitude>;
-  /**
-   * Filters incidents by delay duration.
-   *
-   * @remarks
-   * Allows filtering based on whether incidents have delays and minimum delay thresholds.
-   */
-  delays?: DelayFilter;
-};
-/**
- * Collection of traffic incident filters with OR logic.
- *
- * @remarks
- * Combines multiple incident filter configurations where an incident is shown
- * if it matches **any** of the provided filter criteria (logical OR).
- *
- * This allows for complex filtering scenarios where incidents from different
- * categories or with different characteristics can all be displayed.
- *
- * @example
- * ```ts
- * // Show major incidents OR road closures
- * filters: {
- *   any: [
- *     { magnitudes: { show: 'only', values: ['major'] } },
- *     { incidentCategories: { show: 'only', values: ['road-closed'] } }
- *   ]
- * }
- * ```
- *
- * @group Traffic Incidents
- */
-export type TrafficIncidentsFilters = {
-  /**
-   * Array of incident filters combined with OR logic.
-   *
-   * @remarks
-   * An incident is displayed if it satisfies at least one of the filter configurations.
-   */
-  any: TrafficIncidentsFilter[];
-};
-/**
- * Configuration for the incident icons.
- *
- * @group Traffic Incidents
- */
-export type IncidentIconsConfig = {
-  /**
-   * Shows or hides the incident icons, independently of the incident lines.
-   *
-   * @remarks
-   * When omitted, the icons follow the module's `visible`.
-   */
-  visible?: boolean;
-};
-/**
- * Configuration for traffic incidents module.
- *
- * @remarks
- * One set of `filters` narrows both the incident lines and their icons; `icons` only decides whether
- * the icons are shown.
- *
- * @group Traffic Incidents
- */
-export type TrafficIncidentsModuleConfig = MapModuleCommonConfig & {
-  /**
-   * Controls the visibility of the traffic incident layers, icons included.
-   *
-   * @default false
-   */
-  visible?: boolean;
-  /**
-   * Which incidents are shown, by category, severity, delay and road type — lines and icons alike.
-   */
-  filters?: TrafficIncidentsFilters;
-  /**
-   * Configuration specific to the incident icons.
-   */
-  icons?: IncidentIconsConfig;
-};
-//#endregion
 //#region src/traffic/types/trafficIncidentsFeature.d.ts
 /**
  * Defines the structure of a traffic incident feature, which extends the basic GeoJSON feature with specific properties related to traffic incidents. This type is used to represent individual traffic incidents on the map, providing details such as the description of the incident, its severity, and the road category where it is occurring.
@@ -14361,6 +15310,8 @@ export declare class TrafficIncidentsModule extends AbstractStyleOwnedMapModule<
    * - `ensureAddedToStyle`: Auto-add traffic incidents to style if missing
    * - `filters`: Incident type, severity, and delay filters, for lines and icons alike
    *
+   * {@link trafficIncidentsKnobCatalogue} lists the plain-valued settings as data.
+   *
    * @throws Error if traffic incidents source is not in style and `ensureAddedToStyle` is false
    *
    * @example
@@ -14498,9 +15449,10 @@ export declare class TrafficIncidentsModule extends AbstractStyleOwnedMapModule<
   setVisible(visible: boolean): void;
   private _setVisible;
   /**
-   * Checks if any traffic incident layers are currently visible.
+   * Whether traffic incidents are set to be shown.
    *
-   * @returns `true` if any incident layer is visible, `false` if all are hidden.
+   * @returns The `visible` setting; `false` while nothing has set it, as traffic is hidden until
+   * shown. {@link anyIconLayersVisible} reads the icon layers themselves.
    *
    * @example
    * ```typescript
@@ -14687,4 +15639,4 @@ export declare const calculatePaddedCenter: (options: CalculateMapCenterOptions)
  */
 export declare const calculateFittingBBox: (options: CalculateFittingBBoxOptions) => BBox | null;
 //#endregion
-export type { AREA_ANALYTICS_DEFAULTS, AreaAnalyticsBeforeLayerConfig, AreaAnalyticsColorStop, AreaAnalyticsColorStopsConfig, AreaAnalyticsColorTheme, AreaAnalyticsDisplayMode, AreaAnalyticsHeightConfig, AreaAnalyticsMetricConfig, AreaAnalyticsMetricFilter, AreaAnalyticsRegionPolygonConfig, AreaAnalyticsValueType, AvailabilityLevel, BaseMapColorName, BeforeLayerConfig, BespokeSectionType, ByIdOrIndex, CSSCursor, ChargingSpeedIconMapping, ChargingStopIconConfig, ChargingStopIconMapping, ChargingStopTextConfig, ChargingStopsConfig, CleanEventStateOptions, CleanEventStatesOptions, ClickEventType, CountryCrossingAlignment, CountryCrossingConfig, CountryCrossingFeature, CustomImage, DefaultPlaceIconConfig, DisplayCountryCrossing, DisplayCountryCrossingProps, DisplayCountryCrossings, DisplayRouteProps, DisplayRouteRelatedProps, DisplayRouteSummaries, DisplayRouteSummary, DisplayRouteSummaryProps, DrawnSectionType, EVAvailabilityConfig, EventHandlerConfig, EventHandlerCursorConfig, EventHandlerHoverConfig, EventState, EventType, ExtraFeatureProp, FeaturePropValue, FilterablePOICategory, GeneratedSectionType, GeoJSONSourcesWithLayers, HasAdditionalLayersConfig, HasBeforeID, HoverEventType, HslColor, LabelConfig, LayerQuery, LayerSpecFilter, LayerSpecTemplate, LayerSpecWithSource, LightDark, MapColorName, MapColors, MapEventsConfig, MapFont, MapModuleCommonConfig, MapStyleLayerID, POIsModuleConfig, POIsModuleFeature, PartsBeforeLayerConfig, PlaceClusterBadgeConfig, PlaceConnectionDisplay, PlaceConnectionLayerName, PlaceConnectionsConfig, PlaceConnectionsLayersConfig, PlaceEntryPointFeature, PlaceEntryPointProps, PlaceEntryPointsConfig, PlaceEntryPointsLayersConfig, PlaceEntryPointsShowFor, PlaceIconConfig, PlaceLayerName, PlaceLayersConfig, PlaceTextConfig, PlacesClusterConfig, PlacesModuleConfig, PlacesTheme, PlanningWaypoint, PutEventStateOptions, RGBAColor, RouteLayersConfig, RouteStateProps, RouteWaypointSize, RouteWidth, RoutingBeforeLayerConfig, RoutingModuleConfig, SVGIconStyleOptions, SectionDisplayConfig, SectionDrawStyle, SectionIconConfig, SectionKnobName, SectionKnobOf, SectionLineLayerName, SectionLinePattern, SectionSignConfig, SectionSignLayerName, SectionSignPlacement, SectionSignPriority, SectionSignUnit, SectionSourceKey, SectionSymbolLayerName, SectionsDisplayConfig, SourceWithLayerIDs, SourceWithLayers, SourcesWithLayers, StyleSourcesWithLayers, StylingColorKnobId, StylingKnob, StylingKnobAppliesTo, StylingKnobId, StylingKnobKind, StylingKnobRange, StylingKnobValue, StylingKnobValueOf, StylingPreset, StylingPresetId, StylingSettings, SupportsEvents, SymbolLayerSpecWithoutSource, TRAFFIC_LIGHT_COLORS, TerrainModuleConfig, ToBeAddedLayerSpec, ToBeAddedLayerSpecTemplate, ToBeAddedLayerSpecWithoutSource, TrafficAreaAnalyticsModuleConfig, UserEventHandler, WaypointsConfig };
+export type { AREA_ANALYTICS_DEFAULTS, AreaAnalyticsBeforeLayerConfig, AreaAnalyticsColorStop, AreaAnalyticsColorStopsConfig, AreaAnalyticsColorTheme, AreaAnalyticsDisplayMode, AreaAnalyticsHeightConfig, AreaAnalyticsMetricConfig, AreaAnalyticsMetricFilter, AreaAnalyticsRegionPolygonConfig, AreaAnalyticsValueType, AvailabilityLevel, BaseMapColorName, BaseMapKnob, BaseMapKnobId, BaseMapKnobValueOf, BeforeLayerConfig, BespokeSectionType, ByIdOrIndex, CSSCursor, ChargingSpeedIconMapping, ChargingStopIconConfig, ChargingStopIconMapping, ChargingStopLabelConfig, ChargingStopsConfig, CleanEventStateOptions, CleanEventStatesOptions, ClickEventType, CountryCrossingAlignment, CountryCrossingConfig, CountryCrossingFeature, CustomGeoJSONKnob, CustomGeoJSONKnobId, CustomGeoJSONKnobValueOf, CustomImage, DefaultPlaceIconConfig, DisplayCountryCrossing, DisplayCountryCrossingProps, DisplayCountryCrossings, DisplayRouteProps, DisplayRouteRelatedProps, DisplayRouteSummaries, DisplayRouteSummary, DisplayRouteSummaryProps, DrawnSectionType, EVAvailabilityConfig, EventHandlerConfig, EventHandlerCursorConfig, EventHandlerHoverConfig, EventState, EventType, ExtraFeatureProp, FeaturePropValue, FilterablePOICategory, GeneratedSectionType, GeoJSONSourcesWithLayers, GeometriesKnob, GeometriesKnobId, GeometriesKnobValueOf, HasAdditionalLayersConfig, HasBeforeID, HoverEventType, HslColor, LabelConfig, LayerQuery, LayerSpecFilter, LayerSpecTemplate, LayerSpecWithSource, LightDark, MapColorName, MapColors, MapEventsConfig, MapFont, MapModuleCommonConfig, MapStyleLayerID, POIsKnob, POIsKnobId, POIsKnobValueOf, POIsModuleConfig, POIsModuleFeature, PartsBeforeLayerConfig, PlaceClusterBadgeConfig, PlaceConnectionDisplay, PlaceConnectionLayerName, PlaceConnectionsConfig, PlaceConnectionsLayersConfig, PlaceEntryPointFeature, PlaceEntryPointProps, PlaceEntryPointsConfig, PlaceEntryPointsLayersConfig, PlaceEntryPointsShowFor, PlaceIconConfig, PlaceLabelConfig, PlaceLayerName, PlaceLayersConfig, PlacesClusterConfig, PlacesKnob, PlacesKnobId, PlacesKnobValueOf, PlacesMarkerType, PlacesModuleConfig, PlacesModuleSerializableConfig, PlanningWaypoint, PutEventStateOptions, RGBAColor, RouteLayersConfig, RouteStateProps, RouteWaypointSize, RouteWidth, RoutingBeforeLayerConfig, RoutingKnob, RoutingKnobId, RoutingKnobValueOf, RoutingModuleConfig, RoutingModuleSerializableConfig, SVGIconStyleOptions, SectionDisplayConfig, SectionDrawStyle, SectionIconConfig, SectionIconPlacement, SectionKnobName, SectionKnobOf, SectionLineLayerName, SectionLinePattern, SectionSignConfig, SectionSignLayerName, SectionSignPlacement, SectionSignPriority, SectionSignUnit, SectionSourceKey, SectionSymbolLayerName, SectionsDisplayConfig, SerializableCustomImage, SourceWithLayerIDs, SourceWithLayers, SourcesWithLayers, StyleSourcesWithLayers, StylingColorKnobId, StylingKnob, StylingKnobAppliesTo, StylingKnobId, StylingKnobKind, StylingKnobRange, StylingKnobValue, StylingKnobValueOf, StylingPreset, StylingPresetId, StylingSettings, SupportsEvents, SymbolLayerSpecWithoutSource, TRAFFIC_LIGHT_COLORS, TerrainKnob, TerrainKnobId, TerrainKnobValueOf, TerrainModuleConfig, ToBeAddedLayerSpec, ToBeAddedLayerSpecTemplate, ToBeAddedLayerSpecWithoutSource, TrafficAreaAnalyticsKnob, TrafficAreaAnalyticsKnobId, TrafficAreaAnalyticsKnobValueOf, TrafficAreaAnalyticsModuleConfig, TrafficFlowKnob, TrafficFlowKnobId, TrafficFlowKnobValueOf, TrafficIncidentOverlayKnob, TrafficIncidentOverlayKnobId, TrafficIncidentOverlayKnobValueOf, TrafficIncidentsKnob, TrafficIncidentsKnobId, TrafficIncidentsKnobValueOf, UserEventHandler, WaypointsConfig };