@tomtom-org/maps-sdk 1.0.0-rc.0 → 1.0.0-rc.2

package/map/dist/index.d.ts

@@ -400,6 +400,9 @@ type TomTomMapParams = Partial<GlobalConfig> & {
    * MapLibre keeps its own worker lookup if you already called its `setWorkerUrl`, if MapLibre loads unbundled
    * (from a CDN or an import map), and under bundlers that build classic workers or none, as webpack does by
    * default and Rollup and esbuild do.
+   * Next.js with Turbopack emits neither the worker nor `maplibre-gl-shared.mjs`, which the worker imports
+   * beside itself. Copy both from `maplibre-gl/dist/` into one `public/` directory and call `setWorkerUrl`
+   * before creating the map.
    * Pass `false` to keep MapLibre's lookup in every case.
    *
    * @default true
@@ -461,7 +464,7 @@ type InternalTomTomMapParams = GlobalConfig & TomTomMapParams;
  * // Default: on top of the map, below the geometry titles
  * const geometriesModule = await GeometriesModule.create(map);
  *
- * // Custom: below buildings to show at ground level
+ * // Custom: under the building footprints and the whole road network
  * const geometriesModule = await GeometriesModule.create(map, {
  *   beforeLayerConfig: 'lowestBuilding'
  * });
@@ -507,8 +510,8 @@ export declare const mapStyleLayerIDs: {
    * Country name label layer.
    *
    * @remarks
-   * It sits lower in the stack than most labels. Use it to position elements below country
-   * labels but above other map features.
+   * It sits above every other place label and the POIs; only the traffic incident markers are
+   * higher. Use it to position content below country labels but above every other label.
    */
   readonly country: "Places - Country name";
   /**
@@ -538,7 +541,8 @@ export declare const mapStyleLayerIDs: {
    * - ReachableRangesModule, PlacesModule connections and TrafficIncidentDetailsModule
    * - TrafficAreaAnalyticsModule heatmap and 2D modes
    *
-   * It balances visibility against obscuring map labels.
+   * It balances visibility against obscuring map labels. The 3D buildings sit directly above it,
+   * so content positioned before it also stays under them, and above the roads.
    */
   readonly lowestLabel: "Borders - Treaty label";
   /**
@@ -552,11 +556,12 @@ export declare const mapStyleLayerIDs: {
    */
   readonly lowestRoadLine: "Tunnel - Railway outline";
   /**
-   * The lowest building layer in the stack.
+   * The lowest building layer in the stack, and the lowest of these anchors.
    *
    * @remarks
-   * Use it to position content below 3D building extrusions while keeping it above
-   * flat map features like roads and terrain.
+   * It holds the underground buildings, under the 2D building footprints and the whole road
+   * network. Use it to position content below buildings, roads and labels while keeping it above
+   * land cover and water. To stay above the roads but below the 3D buildings, use `lowestLabel`.
    *
    * **Note:** Not available in the Satellite style.
    */
@@ -1871,7 +1876,10 @@ export declare const DEFAULT_TEXT_SIZE: ExpressionSpecification;
  * All font faces available in the TomTom map style.
  *
  * @remarks
- * Use it to select or validate fonts when creating custom layers.
+ * Use it to select or validate fonts when creating custom layers. The `Noto-*` faces draw every
+ * script the map labels in. The `NotoSerif-*` faces draw no Arabic, and the `NotoSans-*Italic`
+ * faces only Latin, Greek and Cyrillic, so end a stack that names one with the `Noto-*` face of the
+ * same weight.
  *
  * @example
  * ```typescript
@@ -1893,7 +1901,7 @@ export declare const DEFAULT_TEXT_SIZE: ExpressionSpecification;
  *
  * @group Map Style
  */
-export declare const mapFonts: readonly ["Noto-Regular", "NotoSans-MediumItalic", "Noto-Bold", "Noto-Medium"];
+export declare const mapFonts: readonly ["Noto-Regular", "NotoSans-MediumItalic", "Noto-Bold", "Noto-Medium", "NotoSans-RegularItalic", "NotoSans-BoldItalic", "NotoSerif-Regular", "NotoSerif-Medium", "NotoSerif-Bold", "NotoSerif-RegularItalic", "NotoSerif-MediumItalic", "NotoSerif-BoldItalic"];
 /**
  * A font face available in the TomTom map style.
  *
@@ -1922,11 +1930,98 @@ export declare const mapFonts: readonly ["Noto-Regular", "NotoSans-MediumItalic"
  * @group Map Style
  */
 type MapFont = (typeof mapFonts)[number];
+/**
+ * The typefaces the map's labels can be set in, as the `labels.typeface` knob of
+ * {@link stylingFoundationsKnobCatalogue} takes them. A module's own labels take them in their
+ * `typeface` too. `sans` is the style's own.
+ *
+ * @group Map Style
+ */
+export declare const mapTypefaces: readonly ["sans", "sans-italic", "serif", "serif-italic"];
+/**
+ * A typeface the map's labels can be set in. See {@link mapTypefaces}.
+ *
+ * @group Map Style
+ */
+type MapTypeface = (typeof mapTypefaces)[number];
+//#endregion
+//#region src/shared/types/typeface.d.ts
+/**
+ * One font file of a {@link CustomTypeface} and the characters it draws, for a face split into files by
+ * script, as font CDNs serve them.
+ *
+ * @group Shared
+ */
+type CustomTypefaceFile = {
+  /** The file's URL, to a format the browser draws text with, such as WOFF2 or TTF. */
+  url: string;
+  /**
+   * The characters the file draws, as CSS `unicode-range` values such as `U+0100-02BA`. List only the
+   * ones the file has. A character in the range that the file lacks is drawn in the browser's default
+   * sans-serif.
+   */
+  unicodeRange: string[];
+};
+/**
+ * A typeface of your own for map labels, from font files you host or load from a font CDN. The SDK
+ * ships no font, and the map fetches these files itself. Set it for every label on the map through
+ * {@link StylingFoundationsModule}, or for one module's labels through their `customTypeface`.
+ *
+ * Give each weight one file URL, drawing the characters in `unicodeRange`, or a list of
+ * {@link CustomTypefaceFile}s with a range each, such as a font CDN's `latin` and `latin-ext` files.
+ *
+ * @remarks
+ * - Each label keeps its weight and slant. A weight with no file takes the file of the nearest weight
+ *   given, and an italic with none takes the upright file of its weight.
+ * - Characters outside the files' ranges, and every character of a file that fails to load, are drawn
+ *   in the style's own Noto face of the same weight. MapLibre logs a console warning for each file
+ *   that fails, with its URL and the reason.
+ * - The browser draws the files' text one character cluster at a time. A script whose letters join or
+ *   reorder, such as Arabic or Devanagari, reads best left to the style's faces, outside the ranges.
+ *
+ * @example
+ * ```typescript
+ * const fraunces = 'https://cdn.jsdelivr.net/fontsource/fonts/fraunces@5/latin';
+ * await StylingFoundationsModule.get(map, {
+ *   labels: {
+ *     customTypeface: {
+ *       regular: `${fraunces}-400-normal.woff2`,
+ *       bold: `${fraunces}-700-normal.woff2`,
+ *       regularItalic: `${fraunces}-400-italic.woff2`,
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * @group Shared
+ */
+type CustomTypeface = {
+  /** The regular weight, which a weight with no file of its own falls back to. */
+  regular: string | CustomTypefaceFile[];
+  /** The medium weight. */
+  medium?: string | CustomTypefaceFile[];
+  /** The bold weight. */
+  bold?: string | CustomTypefaceFile[];
+  /** The regular italic. */
+  regularItalic?: string | CustomTypefaceFile[];
+  /** The medium italic. */
+  mediumItalic?: string | CustomTypefaceFile[];
+  /** The bold italic. */
+  boldItalic?: string | CustomTypefaceFile[];
+  /**
+   * The characters the files given as a plain URL draw, listed as in
+   * {@link CustomTypefaceFile.unicodeRange}.
+   *
+   * Default: the characters of the `latin` files that Fontsource and Google Fonts serve, which are
+   * Basic Latin, Latin-1 and the common punctuation.
+   */
+  unicodeRange?: string[];
+};
 //#endregion
 //#region src/shared/types/labelConfig.d.ts
 /**
- * How a module's text labels look. Sizes and widths are in pixels, and every field also takes a
- * MapLibre expression.
+ * How a module's text labels look. Sizes and widths are in pixels, and every field but the two
+ * typefaces also takes a MapLibre expression.
  *
  * @group Shared
  */
@@ -1941,8 +2036,21 @@ type LabelConfig = {
   haloWidth?: DataDrivenPropertyValueSpecification<number>;
   /** Text opacity, 0 (transparent) to 1 (opaque). */
   opacity?: DataDrivenPropertyValueSpecification<number>;
-  /** Font faces. The first available one wins. */
+  /**
+   * Font faces. The first available one wins. Leave it out to keep the module's own face, set in the
+   * labels' typeface.
+   */
   font?: DataDrivenPropertyValueSpecification<MapFont[]>;
+  /**
+   * Typeface of these labels alone, each keeping its weight. Leave it out and they follow the map's
+   * typeface, which {@link StylingFoundationsModule} sets. A `customTypeface` or a `font` wins over it.
+   */
+  typeface?: MapTypeface;
+  /**
+   * A typeface of your own font files for these labels alone. It wins over `typeface`, and a `font`
+   * wins over it.
+   */
+  customTypeface?: CustomTypeface;
 };
 /**
  * A {@link LabelConfig} that also sets what the label says, for the labels a module writes beside
@@ -2224,8 +2332,11 @@ declare abstract class AbstractEventProxy {
    */
   protected sourceWithLayersFor(layerId: string | undefined): SourceWithLayers | undefined;
   /**
-   * Updates the given sourcesWithLayers, if they have any handlers.
-   * * (This is typically called to refresh any registered, stale sourceWithLayers references after a map style has changed).
+   * Re-files the owner's handlers over the current layers of the given sources, when that owner has handlers.
+   *
+   * A style change, and a layer added or removed afterwards, both leave the filed layer ids stale. MapLibre
+   * answers a rendered-features query that names a missing layer with nothing, so one stale id blanks every
+   * module's events.
    * @param sourcesWithLayers The new sources with layers to replace existing ones.
    * @param owner The module whose sources these are. Only its own handlers are refreshed: two
    * modules can share one MapLibre source ID, so the ID alone cannot tell them apart.
@@ -2386,23 +2497,27 @@ type StylingFoundationsKnob = KnobEntry<StylingFoundationsKnobId, StylingFoundat
   appliesTo: StylingFoundationsKnobAppliesTo;
 };
 /**
- * A serializable set of styling knob values, as {@link StylingFoundationsModule.getConfig} returns and
- * {@link StylingFoundationsModule.applyConfig} accepts. Persist it, put it in a pull request or ship it in a
- * preset. Re-applying it on a later SDK version keeps working for as long as the knob ids do.
+ * The styling settings, as {@link StylingFoundationsModule.getConfig} returns and
+ * {@link StylingFoundationsModule.applyConfig} accepts. Each knob id is its path in here, so the
+ * `view.sky.color` knob is `config.view.sky.color`. It's plain JSON, so persist it, diff it or ship it.
+ * `labels.customTypeface` is the one setting that isn't a knob, since no knob kind takes font files.
+ * While set, it wins over the `labels.typeface` knob.
  *
  * @example
  * ```typescript
  * const settings: StylingFoundationsModuleConfig = {
- *   'labels.sizeFactor': 1.2,
- *   'colors.water': '#7cc4e8',
- *   'view.projection': 'globe',
+ *   labels: { sizeFactor: 1.2 },
+ *   colors: { water: '#7cc4e8' },
+ *   view: { projection: 'globe' },
  * };
  * styling.applyConfig(settings);
  * ```
  *
  * @group Map Styling
  */
-type StylingFoundationsModuleConfig = MapModuleCommonConfig & { [K in StylingFoundationsKnobId]?: StylingFoundationsKnobValueOf<K>; };
+type StylingFoundationsModuleConfig = MapModuleCommonConfig & KnobConfigOf<{ [ID in StylingFoundationsKnobId]: StylingFoundationsKnobValueOf<ID>; }> & {
+  labels?: Pick<LabelConfig, 'customTypeface'>;
+};
 //#endregion
 //#region src/styling/knobCatalogue.d.ts
 type KnobDefinitionOf<KIND extends StylingFoundationsKnobKind> = Omit<KnobEntry<string, KIND>, 'id' | 'default'> & {
@@ -2463,6 +2578,12 @@ declare const knobDefinitions: {
   readonly 'labels.sizeFactor': KnobDefinitionOf<"factor">;
   readonly 'symbols.sizeFactor': KnobDefinitionOf<"factor">;
   readonly 'roads.widthFactor': KnobDefinitionOf<"factor">;
+  readonly 'labels.typeface': {
+    readonly kind: "enum";
+    readonly description: "Typeface of every map label, each keeping its weight. The SDK's own labels follow it unless their module sets a typeface or a `font` of its own. The serif and italic faces lack some scripts, which the style's own face draws instead. A `labels.customTypeface` of your own font files, set through the module's config, wins over it.";
+    readonly options: readonly ["sans", "sans-italic", "serif", "serif-italic"];
+    readonly appliesTo: "tomtom-styles";
+  };
 };
 /**
  * The id of a styling knob. {@link stylingFoundationsKnobCatalogue} describes what each one does.
@@ -3010,6 +3131,13 @@ export type KnobRange = {
  * @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;
+type KnobIdHead<ID extends string> = ID extends `${infer HEAD}.${string}` ? HEAD : ID;
+/**
+ * The configuration a catalogue's knobs are paths into, for a catalogue declared before its
+ * configuration: `{ 'view.sky.color': string }` gives `{ view?: { sky?: { color?: string } } }`.
+ * @ignore
+ */
+export type KnobConfigOf<VALUES> = { [HEAD in KnobIdHead<keyof VALUES & string>]?: HEAD extends keyof VALUES ? VALUES[HEAD] : KnobConfigOf<{ [ID in keyof VALUES & string as ID extends `${HEAD}.${infer REST}` ? REST : never]: VALUES[ID]; }>; };
 /**
  * A knob catalogue entry, with what a UI or a coding agent needs to offer a knob and validate its
  * values with no map loaded. A catalogue may add fields of its own.
@@ -3044,10 +3172,9 @@ export type KnobEntry<ID extends string, KIND extends KnobKind = KnobKind> = KIN
 //#endregion
 //#region src/shared/knobUtils.d.ts
 /**
- * The value at a dotted path into T, or `never` where the path names nothing. A path that is a key
- * of T as a whole names that key, as the flat ids of `StylingFoundationsModuleConfig` do. A union is read member by
- * member, so `highlight.line.widthFactor` resolves through `false | IncidentHighlightConfig`. No path reaches
- * into a list.
+ * The value at a dotted path into T, or `never` where the path names nothing. A union is read member
+ * by member, so `highlight.line.widthFactor` resolves through `false | IncidentHighlightConfig`. No
+ * path reaches into a list.
  * @ignore
  */
 type ValueAt<T, PATH extends string> = T extends unknown ? PATH extends keyof T ? NonNullable<T[PATH]> : PATH extends `${infer HEAD}.${infer REST}` ? HEAD extends keyof T ? ValueAt<NonNullable<T[HEAD]>, REST> : never : never : never;
@@ -4008,12 +4135,12 @@ type PlacesModuleSerializableConfig = Omit<PlacesModuleConfig, 'label' | 'icon'
  * `cluster.badge.color`. See {@link placesKnobCatalogue} for what each one does.
  *
  * @remarks
- * Only plain-value settings are knobs. `label.title`, `cluster.source.properties`,
+ * Only plain-value settings are knobs. `label.title`, `label.customTypeface`, `cluster.source.properties`,
  * `connections.label.title` and anything holding an image, a callback or MapLibre layers are not.
  *
  * @group Places
  */
-type PlacesKnobId = 'markerType' | 'color' | 'visible' | `icon.default.style.${keyof SVGIconStyleOptions}` | `label.${Exclude<keyof PlaceLabelConfig, 'title'>}` | `cluster.badge.${Exclude<keyof PlaceClusterBadgeConfig, 'radius' | 'label'>}` | `cluster.badge.label.${keyof NonNullable<PlaceClusterBadgeConfig['label']>}` | `cluster.badge.radius.${keyof NonNullable<PlaceClusterBadgeConfig['radius']>}` | `cluster.source.${Exclude<keyof NonNullable<PlacesClusterConfig['source']>, 'properties'>}` | `entryPoints.${Exclude<keyof PlaceEntryPointsConfig, 'layers'>}` | `connections.${Exclude<keyof PlaceConnectionsConfig, 'label' | 'layers'>}` | `connections.label.${Exclude<keyof PlaceConnectionLabelConfig, 'title'>}`;
+type PlacesKnobId = 'markerType' | 'color' | 'visible' | `icon.default.style.${keyof SVGIconStyleOptions}` | `label.${Exclude<keyof PlaceLabelConfig, 'title' | 'customTypeface'>}` | `cluster.badge.${Exclude<keyof PlaceClusterBadgeConfig, 'radius' | 'label'>}` | `cluster.badge.label.${keyof NonNullable<PlaceClusterBadgeConfig['label']>}` | `cluster.badge.radius.${keyof NonNullable<PlaceClusterBadgeConfig['radius']>}` | `cluster.source.${Exclude<keyof NonNullable<PlacesClusterConfig['source']>, 'properties'>}` | `entryPoints.${Exclude<keyof PlaceEntryPointsConfig, 'layers'>}` | `connections.${Exclude<keyof PlaceConnectionsConfig, 'label' | 'layers'>}` | `connections.label.${Exclude<keyof PlaceConnectionLabelConfig, 'title'>}`;
 /**
  * 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
@@ -5011,11 +5138,11 @@ type POIsKnob = KnobEntry<POIsKnobId, 'toggle' | 'enum' | 'enums' | 'factor' | '
  */
 type MapPresetSettings = {
   /** {@link StylingFoundationsModule} knobs, from {@link stylingFoundationsKnobCatalogue}. */
-  stylingFoundations?: Omit<StylingFoundationsModuleConfig, 'events'>;
+  stylingFoundations?: KnobValues<StylingFoundationsModuleConfig, StylingFoundationsKnobId>;
   /** {@link BaseMapModule} knobs, from {@link baseMapKnobCatalogue}. */
-  baseMap?: { [ID in BaseMapKnobId]?: BaseMapKnobValueOf<ID>; };
+  baseMap?: KnobValues<BaseMapModuleConfig, BaseMapKnobId>;
   /** {@link POIsModule} knobs, from {@link poisKnobCatalogue}. */
-  pois?: { [ID in POIsKnobId]?: POIsKnobValueOf<ID>; };
+  pois?: KnobValues<POIsModuleConfig, POIsKnobId>;
 };
 type PresetDefinition = {
   name: string;
@@ -5165,8 +5292,9 @@ export type StylingFoundationsEvents = CombinedEvents<MapGeoJSONFeature, Styling
  * It is the tier between showing or hiding a part of the map and hand-editing MapLibre layers. Every
  * adjustable thing is a **knob** with a stable id, a kind, a range and a default read from the loaded
  * style. The ids form the {@link StylingFoundationsKnobId} union, and {@link stylingFoundationsKnobCatalogue} lists
- * each one's kind, range and description as data, with no map needed to read it. {@link setKnob},
- * {@link getKnob} and {@link resetKnob} set, read and unset a knob by its id, as on every module.
+ * each one's kind, range and description as data, with no map needed to read it. Each id is its path
+ * into {@link StylingFoundationsModuleConfig}. {@link setKnob}, {@link setKnobs}, {@link getKnob} and
+ * {@link resetKnob} set, read and unset knobs by id, as on every module.
  *
  * @remarks
  * The catalogue's `appliesTo` says which styles a knob works on. `any-style` knobs (sizes, widths)
@@ -5186,11 +5314,10 @@ export type StylingFoundationsEvents = CombinedEvents<MapGeoJSONFeature, Styling
  *
  * @example
  * ```typescript
- * import { getKnob, setKnob, StylingFoundationsModule, stylingFoundationsKnobCatalogue } from '@tomtom-org/maps-sdk/map';
+ * import { getKnob, setKnobs, StylingFoundationsModule, stylingFoundationsKnobCatalogue } from '@tomtom-org/maps-sdk/map';
  *
  * const styling = await StylingFoundationsModule.get(map);
- * setKnob(styling, stylingFoundationsKnobCatalogue, 'labels.sizeFactor', 1.2);
- * setKnob(styling, stylingFoundationsKnobCatalogue, 'colors.water', '#7cc4e8');
+ * setKnobs(styling, stylingFoundationsKnobCatalogue, { 'labels.sizeFactor': 1.2, 'colors.water': '#7cc4e8' });
  *
  * // The catalogue as data, and each knob's value in force:
  * for (const knob of stylingFoundationsKnobCatalogue) {
@@ -5223,7 +5350,7 @@ export declare class StylingFoundationsModule extends AbstractStyleOwnedMapModul
    *
    * @example
    * ```typescript
-   * const styling = await StylingFoundationsModule.get(map, { 'labels.sizeFactor': 1.2 });
+   * const styling = await StylingFoundationsModule.get(map, { labels: { sizeFactor: 1.2 } });
    * ```
    */
   static get(map: TomTomMap, settings?: StylingFoundationsModuleConfig): Promise<StylingFoundationsModule>;
@@ -5262,14 +5389,6 @@ export declare class StylingFoundationsModule extends AbstractStyleOwnedMapModul
    * @ignore
    */
   _knobValue(id: string): unknown;
-  /**
-   * @ignore
-   */
-  _setKnobValue(id: string, value: unknown): void;
-  /**
-   * @ignore
-   */
-  _resetKnobValue(id: string): void;
   /**
    * Recolours the whole base map with up to ten semantic colours in one call, and sets `accent`, the
    * default colour of routes, geometries and places ({@link TomTomMap.mapColors}).
@@ -5306,6 +5425,8 @@ export declare class StylingFoundationsModule extends AbstractStyleOwnedMapModul
    * @remarks
    * It includes whatever the SDK's data modules (places, routes) have on the map. Its tile URLs
    * carry the API key the map was created with, so strip or rotate the key before publishing.
+   * Labels set in a `customTypeface` come out in the style's own Noto faces, since only the SDK can
+   * draw font files beside the glyph service.
    */
   exportStyle(): StyleSpecification;
   /**
@@ -5318,7 +5439,6 @@ export declare class StylingFoundationsModule extends AbstractStyleOwnedMapModul
    * ```
    */
   get events(): StylingFoundationsEvents;
-  private assertKnob;
   private warnOnce;
 }
 //#endregion
@@ -5460,6 +5580,13 @@ declare const stylingFoundationsStyleKnobs: {
   readonly 'labels.sizeFactor': StyleKnobDefinition<"factor">;
   readonly 'symbols.sizeFactor': StyleKnobDefinition<"factor">;
   readonly 'roads.widthFactor': StyleKnobDefinition<"factor">;
+  readonly 'labels.typeface': {
+    readonly kind: "enum";
+    readonly mechanisms: [{
+      readonly type: "typeface";
+      readonly layers: [LayerSelector];
+    }];
+  };
 };
 //#endregion
 //#region src/styling/styleKnobDefinitions.d.ts
@@ -5526,6 +5653,11 @@ type LayerStyleKnobMechanism =
 {
   type: 'zoomOffset';
   layers: LayerSelector[];
+} |
+/** Sets the matched layers' `text-font` in the knob's typeface, each face keeping its weight and slant. */
+{
+  type: 'typeface';
+  layers: LayerSelector[];
 };
 /**
  * How a {@link StylingFoundationsModule} knob reaches the look of the whole map, through the map-look extension
@@ -6159,6 +6291,7 @@ export declare class TomTomMap {
   private applyStyle;
   private loadIntoMapLibre;
   private isSuperseded;
+  private fitCanvasToContainer;
   private recordStyleLayers;
   /**
    * Whether the loaded style itself declares the layer, as opposed to a module or the caller adding it.
@@ -7108,10 +7241,6 @@ export declare abstract class AbstractMapModule<SOURCES_WITH_LAYERS extends Sour
    * @ignore
    */
   protected sourcesWithLayers: SOURCES_WITH_LAYERS;
-  /**
-   * @ignore
-   */
-  protected _sourceAndLayerIDs: Record<keyof SOURCES_WITH_LAYERS, SourceWithLayerIDs>;
   /**
    * @ignore
    */
@@ -7202,6 +7331,10 @@ export declare abstract class AbstractMapModule<SOURCES_WITH_LAYERS extends Sour
    * The given configuration **replaces** the current one
    * rather than being merged into it. To change one part of it, use {@link updateConfig}.
    *
+   * Use it for settings your code writes. It takes every setting, typed, including the ones no knob
+   * covers (layer specs, callbacks, MapLibre expressions), and checks no value at run time. For
+   * settings held as data, from a control, storage or a language model, use {@link setKnobs}.
+   *
    * @example
    * ```typescript
    * // Apply a new configuration
@@ -7223,6 +7356,11 @@ export declare abstract class AbstractMapModule<SOURCES_WITH_LAYERS extends Sour
    * {@link applyConfig}. This works the same on every module, whatever its `applyConfig` does with
    * a whole configuration.
    *
+   * @remarks
+   * Use it for settings your code writes, as {@link applyConfig}: typed, and not checked at run
+   * time. To change nested values and keep the ones beside them, or to set values held as data,
+   * use {@link setKnobs}, which reaches each by its path and checks it.
+   *
    * @param partial - The properties to change.
    *
    * @example
@@ -7328,7 +7466,7 @@ export declare abstract class AbstractMapModule<SOURCES_WITH_LAYERS extends Sour
   /**
    * @ignore
    */
-  _setKnobValue(id: string, value: unknown): void;
+  _setKnobValues(values: Readonly<Record<string, unknown>>): void;
   /**
    * @ignore
    */
@@ -7597,6 +7735,13 @@ export declare abstract class AbstractDataOwnedMapModule<SOURCES_WITH_LAYERS ext
    * ```
    */
   getEventStates(): EventStateIds;
+  /**
+   * Swaps the layers of one of this module's sources for `newSpecs`, then re-files this module's
+   * event handlers over the layers it now has. See {@link AbstractEventProxy.updateIfRegistered}.
+   * @protected
+   * @ignore
+   */
+  protected replaceSourceLayers(newSpecs: ToBeAddedLayerSpecWithoutSource[], oldSpecs: ToBeAddedLayerSpecWithoutSource[], source: GeoJSONSourceWithLayers): void;
 }
 //#endregion
 //#region src/shared/layers/layerVisibilityComposer.d.ts
@@ -7686,8 +7831,8 @@ export declare abstract class AbstractStyleOwnedMapModule<SOURCES_WITH_LAYERS ex
  */
 export declare const validateKnobValue: (knob: KnobEntry<string>, value: unknown) => void;
 /**
- * What {@link setKnob}, {@link getKnob} and {@link resetKnob} act on, which is every map module
- * and any plugin with knobs of its own, such as the map-effects plugin's `MapEffects`.
+ * What {@link setKnob}, {@link setKnobs}, {@link getKnob} and {@link resetKnob} act on, which is
+ * every map module and any plugin with knobs of its own, such as the map-effects plugin's `MapEffects`.
  *
  * @group Shared
  */
@@ -7696,12 +7841,44 @@ export type KnobTarget<CONFIG> = {
   /** @ignore */
   _knobValue(id: string): unknown;
   /** @ignore */
-  _setKnobValue(id: string, value: unknown): void;
+  _setKnobValues(values: Readonly<Record<string, unknown>>): void;
   /** @ignore */
   _resetKnobValue(id: string): void;
 };
+/**
+ * The value at a knob id's dotted path into a configuration. With {@link configWithKnobs} and
+ * {@link configWithoutKnob}, it is what every {@link KnobTarget}'s hooks are made of.
+ * @ignore
+ */
+export declare const knobValueIn: (config: unknown, id: string) => unknown;
+/**
+ * The configuration with each value at its knob id's path, keeping the settings beside it. Each
+ * object along a path is copied, so the configuration passed in is left as it was.
+ * @ignore
+ */
+export declare const configWithKnobs: <CONFIG extends object>(config: CONFIG, values: Readonly<Record<string, unknown>>) => CONFIG;
+/**
+ * The configuration without the value at a knob id's path, dropping each object that leaves empty.
+ * @ignore
+ */
+export declare const configWithoutKnob: <CONFIG extends object>(config: CONFIG, id: string) => CONFIG;
 type KnobInput<CONFIG, KNOB extends string> = string extends KNOB ? unknown : KnobPlainValue<ValueAt<CONFIG, KNOB>>;
 type KnobOutput<CONFIG, KNOB extends string> = string extends KNOB ? unknown : ValueAt<CONFIG, KNOB> | undefined;
+/**
+ * Knob values by id, as {@link setKnobs} takes them: a flat, JSON-safe record to store, ship as a
+ * preset or take from a language model.
+ *
+ * @typeParam CONFIG - The module's configuration, which types each value by its knob's path.
+ * @typeParam ID - The knob ids of its catalogue. Any `string` takes any value, checked when set.
+ *
+ * @example
+ * ```typescript
+ * const saved: KnobValues<RoutingModuleConfig, RoutingKnobId> = { widthPreset: 'l', 'waypoints.label.color': '#e63312' };
+ * ```
+ *
+ * @group Shared
+ */
+export type KnobValues<CONFIG, ID extends string> = { readonly [KNOB in ID]?: KnobInput<CONFIG, KNOB>; };
 /**
  * A knob's entry in its catalogue: its kind, range or options, default and description.
  *
@@ -7721,8 +7898,12 @@ export declare const knobEntryOf: <ENTRY extends KnobEntry<string>>(catalogue: r
  *
  * @remarks
  * Nothing changes when the value is invalid. A knob's id is its dotted path into the module's
- * configuration, or its key there for `StylingFoundationsModule`. The change therefore also shows
- * in `getConfig` and fires a `config-change` event.
+ * configuration, so the change also shows in `getConfig` and fires a `config-change` event. To
+ * set several knobs in one change, use {@link setKnobs}.
+ *
+ * Use it for a value held as data, from a control, storage or a language model, since it checks the
+ * value and keeps the settings beside it. For typed settings your code writes, including the ones no
+ * knob covers, use the module's `applyConfig` or `updateConfig`, which check nothing at run time.
  *
  * @param module - A map module, or a plugin with knobs, such as `MapEffects`.
  * @param catalogue - Its knob catalogue, e.g. `trafficFlowKnobCatalogue` for a `TrafficFlowModule`.
@@ -7738,6 +7919,37 @@ export declare const knobEntryOf: <ENTRY extends KnobEntry<string>>(catalogue: r
  * @group Shared
  */
 export declare const setKnob: <CONFIG, ID extends string, KNOB extends ID>(module: KnobTarget<CONFIG>, catalogue: readonly KnobEntry<ID>[], id: KNOB, value: KnobInput<CONFIG, KNOB>) => void;
+/**
+ * Sets several knobs by their catalogue ids in one change, after checking every value with
+ * {@link validateKnobValue}, and keeps every other setting.
+ *
+ * @remarks
+ * Nothing changes when any id or value is invalid. Otherwise the module applies its configuration
+ * once, so it redraws and fires `config-change` once, however many knobs you set.
+ *
+ * Use the knob functions for settings held as data, and the module's config methods for settings
+ * your code writes:
+ * - `setKnob` / `setKnobs` take ids and values from a control, storage, a URL or a language model.
+ *   They check each value, reach a nested setting and keep the ones beside it, and cover the
+ *   plain-valued settings the catalogue lists.
+ * - `applyConfig` / `updateConfig` take a typed configuration, including what no knob covers
+ *   (layer specs, callbacks, MapLibre expressions). They check nothing at run time, and
+ *   `updateConfig` replaces a nested object you pass.
+ *
+ * @param module - A map module, or a plugin with knobs, such as `MapEffects`.
+ * @param catalogue - Its knob catalogue, e.g. `routingKnobCatalogue` for a `RoutingModule`.
+ * @param values - The values by knob id. An empty record changes nothing.
+ * @throws `RangeError` for a value its knob does not take; `Error` for an id the catalogue lacks.
+ *
+ * @example
+ * ```typescript
+ * setKnobs(routing, routingKnobCatalogue, { widthPreset: 'l', 'waypoints.label.color': '#e63312' });
+ * setKnobs(styling, stylingFoundationsKnobCatalogue, JSON.parse(localStorage.getItem('styling') ?? '{}'));
+ * ```
+ *
+ * @group Shared
+ */
+export declare const setKnobs: <CONFIG, ID extends string>(module: KnobTarget<CONFIG>, catalogue: readonly KnobEntry<ID>[], values: KnobValues<CONFIG, ID>) => void;
 /**
  * Returns the value set for a knob, otherwise the module's own value where it knows it
  * (`StylingFoundationsModule` reads the loaded style), otherwise the catalogue's default.
@@ -9221,6 +9433,7 @@ export declare abstract class AbstractGeometriesModule<CFG extends MapModuleComm
   protected applyVisibility(config: CFG | undefined): void;
   private get partLayerIDs();
   private applyBeforeLayerConfig;
+  private labelLayerSpecs;
   private updateLayers;
   /**
    * @ignore
@@ -9563,17 +9776,17 @@ export declare const fillStyledGeometryConfig: ({ palette, beforeLayerConfig }?:
 //#endregion
 //#region src/geometry/types/geometriesKnobs.d.ts
 /**
- * The style fields both geometry labels share, as knobs: the {@link LabelConfig} fields.
+ * The style fields both geometry labels share, as knobs: the {@link LabelConfig} fields but its font files.
  * @ignore
  */
-type GeometryLabelKnobLeaf = keyof LabelConfig;
+type GeometryLabelKnobLeaf = Exclude<keyof LabelConfig, 'customTypeface'>;
 /**
  * A geometries knob's id, its path into {@link GeometriesModuleConfig}, such as `fill.opacity` or
  * `lineLabel.minZoom`. See {@link geometriesKnobCatalogue} for what each one does.
  *
  * @group Geometries
  */
-type GeometriesKnobId = 'color' | 'visible' | `fill.${keyof GeometryFillConfig}` | `line.${keyof GeometryLineConfig}` | `highlight.${LeafPathOf<GeometryHighlightConfig>}` | `label.${Exclude<keyof GeometryLabelConfig, 'title'>}` | `lineLabel.${Exclude<keyof GeometryLineLabelConfig, 'title'>}`;
+type GeometriesKnobId = 'color' | 'visible' | `fill.${keyof GeometryFillConfig}` | `line.${keyof GeometryLineConfig}` | `highlight.${LeafPathOf<GeometryHighlightConfig>}` | `label.${Exclude<keyof GeometryLabelConfig, 'title' | 'customTypeface'>}` | `lineLabel.${Exclude<keyof GeometryLineLabelConfig, 'title' | 'customTypeface'>}`;
 /**
  * The value type of a geometries knob, the plain value its path holds in
  * {@link GeometriesModuleConfig}. The MapLibre expressions the config also takes there are not knob
@@ -11055,6 +11268,25 @@ type RouteLayersConfig = {
      */
     routeCountryCrossing?: Partial<ToBeAddedLayerSpecTemplate<SymbolLayerSpecification>>;
   } & HasAdditionalLayersConfig;
+  /**
+   * Layers of the sections {@link RoutingModule.setSectionFocus} marks.
+   *
+   * @remarks
+   * Anything {@link RouteHighlightConfig} `section` cannot express about the ring.
+   */
+  sectionFocus?: {
+    /**
+     * Line layer ringing each focused section of the selected route, drawn with a
+     * `line-gap-width` as wide as the widest line along the route, so the route and its
+     * sections show through.
+     */
+    routeSectionFocusOutline?: Partial<ToBeAddedLayerSpecTemplate<LineLayerSpecification>>;
+    /**
+     * Line layer ringing each focused section of a deselected route, under the selected
+     * route where they cross.
+     */
+    routeDeselectedSectionFocusOutline?: Partial<ToBeAddedLayerSpecTemplate<LineLayerSpecification>>;
+  } & HasAdditionalLayersConfig;
 };
 /**
  * The waypoint pins, one per role (origin, stops, destination), each in the SDK's pin or an image
@@ -11424,8 +11656,8 @@ type SectionSignConfig = {
   /**
    * The lowest zoom the signs are drawn at.
    *
-   * @defaultValue 10, where a sign is about a stretch of road a reader can see. Further out the
-   * stretches fall in the same few pixels and the surviving signs are an arbitrary sample.
+   * @defaultValue 11, one zoom past the tunnel and closed-road signs. A route posts many more
+   * speed limits, and further out they crowd the overview of the route.
    */
   minZoom?: number;
   /**
@@ -11525,13 +11757,14 @@ type CountryCrossingLabelConfig = {
   color?: string;
 };
 /**
- * The highlight of a hovered or clicked route, selected or not, which widens its outline in the
- * outline colour.
+ * The highlights the routes draw: a hovered or clicked route widens its outline in the outline
+ * colour, and a focused section is ringed clear of every line the route draws.
  *
  * @remarks
  * The routes draw their event states once a handler covers them, or
  * {@link RoutingModule.setEventState} puts one. A `layers.mainLines` outline `line-width` is drawn
- * as given instead.
+ * as given instead. The sections {@link RoutingModule.setSectionFocus} marks draw the `section`
+ * highlight.
  *
  * @group Routing
  */
@@ -11548,6 +11781,27 @@ type RouteHighlightConfig = {
      */
     widthFactor?: number;
   };
+  /** The focused sections, ringed on both sides of the route without covering what it draws. */
+  section?: {
+    /** The ring, which runs clear of the widest line the route draws: its hovered outline or a section. */
+    outline?: {
+      /**
+       * The ring's colour.
+       *
+       * @defaultValue `#000` on light map styles, `#FFF` on dark styles
+       */
+      color?: string;
+      /**
+       * Multiplier on the ring's width, which grows from 2 to 4 pixels as the zoom grows.
+       *
+       * @remarks
+       * Clamped to 0.5 to 2, its `range` in {@link routingKnobCatalogue}.
+       *
+       * @defaultValue `1`
+       */
+      widthFactor?: number;
+    };
+  };
 };
 /**
  * Appearance of one route section type.
@@ -11780,7 +12034,7 @@ type RoutingModuleSerializableConfig = Omit<RoutingModuleConfig, 'waypoints'> &
  *
  * @group Routing
  */
-type RoutingKnobId = 'visible' | 'color' | 'widthPreset' | 'widthFactor' | `highlight.${LeafPathOf<RouteHighlightConfig>}` | 'waypoints.sizePreset' | 'waypoints.sizeFactor' | `waypoints.icon.style.${keyof SVGIconStyleOptions}` | `waypoints.icon.${WaypointIndexType}.style.${keyof SVGIconStyleOptions}` | 'waypoints.stopNumbering' | `waypoints.label.${Exclude<keyof WaypointLabelConfig, 'title'>}` | `waypoints.highlight.${keyof WaypointHighlightConfig}` | 'waypoints.entryPoints' | `displayUnits.distance.${keyof DistanceDisplayUnits}` | `displayUnits.time.${keyof TimeDisplayUnits}` | 'summaryBubbles.visible' | `countryCrossings.${Exclude<keyof CountryCrossingConfig, 'label'>}` | `countryCrossings.label.${keyof CountryCrossingLabelConfig}` | { [T in DrawnSectionType]: `sections.${T}.${LeafPathOf<SectionDisplayConfig<T>>}`; }[DrawnSectionType];
+type RoutingKnobId = 'visible' | 'color' | 'widthPreset' | 'widthFactor' | `highlight.outline.${keyof NonNullable<RouteHighlightConfig['outline']>}` | `highlight.section.${LeafPathOf<NonNullable<RouteHighlightConfig['section']>>}` | 'waypoints.sizePreset' | 'waypoints.sizeFactor' | `waypoints.icon.style.${keyof SVGIconStyleOptions}` | `waypoints.icon.${WaypointIndexType}.style.${keyof SVGIconStyleOptions}` | 'waypoints.stopNumbering' | `waypoints.label.${Exclude<keyof WaypointLabelConfig, 'title' | 'customTypeface'>}` | `waypoints.highlight.${keyof WaypointHighlightConfig}` | 'waypoints.entryPoints' | `displayUnits.distance.${keyof DistanceDisplayUnits}` | `displayUnits.time.${keyof TimeDisplayUnits}` | 'summaryBubbles.visible' | `countryCrossings.${Exclude<keyof CountryCrossingConfig, 'label'>}` | `countryCrossings.label.${keyof CountryCrossingLabelConfig}` | { [T in DrawnSectionType]: `sections.${T}.${LeafPathOf<SectionDisplayConfig<T>>}`; }[DrawnSectionType];
 /**
  * The plain value type that a routing knob's path holds in {@link RoutingModuleConfig}.
  *
@@ -12406,6 +12660,7 @@ type RoutingSourcesWithLayers = { [K in SectionSourceKey<GeneratedSectionType>]:
   instructionArrows: GeoJSONSourceWithLayers<DisplayInstructionArrows>;
   summaryBubbles: GeoJSONSourceWithLayers<DisplayRouteSummaries>;
   countryCrossings: GeoJSONSourceWithLayers<DisplayCountryCrossings>;
+  sectionFocus: GeoJSONSourceWithLayers<RouteSections>;
 };
 //#endregion
 //#region src/routing/types/showOptions.d.ts
@@ -12712,7 +12967,7 @@ export declare class RoutingModule extends AbstractDataOwnedMapModule<RoutingSou
    * markers. To show them, call {@link showWaypoints} separately.
    *
    * This method:
-   * - Replaces any previously shown routes
+   * - Replaces any previously shown routes, and clears the {@link setSectionFocus} focus
    * - Shows all route-related features: lines, sections, guidance and summary bubbles
    * - Selects the first route by default, which then appears more prominent
    *
@@ -12747,6 +13002,28 @@ export declare class RoutingModule extends AbstractDataOwnedMapModule<RoutingSou
    * ```
    */
   showRoutes(routes: Route | Routes, options?: ShowRoutesOptions): Promise<void>;
+  /**
+   * Rings the given sections of the shown routes, or clears the ring with `null`.
+   *
+   * @param sectionIds - The `id` of each section to focus, from any route shown and of any type,
+   * drawn or not. An id no shown section carries is skipped.
+   *
+   * @remarks
+   * The ring runs on both sides of the route, clear of the widest line it draws, whether its
+   * hovered outline or a section, so the route and every section along it stay in sight. A
+   * deselected route's ring sits under the selected route. {@link RouteHighlightConfig} `section`
+   * styles it. Each call replaces the focus, and {@link showRoutes} clears it.
+   *
+   * @example
+   * ```typescript
+   * // Point out the route's ferry crossings, say while a timeline row hovers them
+   * const ferries = route.properties.sections.ferry ?? [];
+   * await routingModule.setSectionFocus(ferries.map((section) => section.id));
+   *
+   * await routingModule.setSectionFocus(null);
+   * ```
+   */
+  setSectionFocus(sectionIds: readonly string[] | null): Promise<void>;
   /**
    * Clears any previously shown routes from the map.
    *
@@ -12836,6 +13113,7 @@ export declare class RoutingModule extends AbstractDataOwnedMapModule<RoutingSou
    * - `instructionArrows`: Instruction arrow markers
    * - `summaryBubbles`: Route summary popups
    * - `countryCrossings`: Border crossings along the route
+   * - `sectionFocus`: The sections `setSectionFocus()` rings
    *
    * @example
    * ```typescript
@@ -12862,6 +13140,7 @@ export declare class RoutingModule extends AbstractDataOwnedMapModule<RoutingSou
     instructionArrows: DisplayInstructionArrows;
     summaryBubbles: DisplayRouteSummaries;
     countryCrossings: DisplayCountryCrossings;
+    sectionFocus: RouteSections;
     carpoolSections: RouteSections | undefined;
     carTrainSections: RouteSections | undefined;
     importantRoadStretchSections: RouteSections | undefined;
@@ -13241,6 +13520,7 @@ export declare class TerrainModule extends AbstractStyleOwnedMapModule<TerrainSo
   get events(): ModuleEvents<TerrainModuleConfig>;
   private showHillshade;
   private showElevation;
+  private setMapTerrain;
   private storeConfig;
 }
 //#endregion
@@ -14729,8 +15009,8 @@ export declare class TrafficAreaAnalyticsModule extends AbstractDataOwnedMapModu
  * the traffic flow vector tiles.
  *
  * @remarks
- * `absoluteSpeed`, `partOfTwoWayRoad` and `openlr` stay `undefined`, because the standard styles
- * do not request their tile tags.
+ * The SDK requests every tile tag these properties come from, so `absoluteSpeed` and `openlr` are
+ * on each section; `partOfTwoWayRoad` is there only when `true`.
  * No flow tile carries free-flow speed, travel time, delay or confidence. For historical speed and
  * congestion over an area, use the Traffic Area Analytics service.
  *
@@ -14939,8 +15219,8 @@ export declare class TrafficFlowModule extends AbstractStyleOwnedMapModule<Traff
    *
    * @remarks
    * This is the only way to read live flow values, because Orbis traffic flow is vector tiles, with
-   * no service for a road, a point or an area. Results cover the current viewport and zoom, and a segment crossing a
-   * tile boundary appears once per tile. See {@link TrafficFlowModuleFeature} for what each carries.
+   * no service for a road, a point or an area. Results cover what is drawn in the current viewport and zoom, so a
+   * hidden module returns none, and a segment crossing a tile boundary appears once per tile. See {@link TrafficFlowModuleFeature} for what each carries.
    *
    * @example
    * ```typescript
@@ -15567,4 +15847,4 @@ export declare const calculatePaddedCenter: (options: CalculateMapCenterOptions)
  */
 export declare const calculateFittingBBox: (options: CalculateFittingBBoxOptions) => BBox | null;
 //#endregion
-export type { AreaAnalyticsBeforeLayerConfig, AreaAnalyticsColorStop, AreaAnalyticsColorStopsConfig, AreaAnalyticsDisplayMode, AreaAnalyticsHeightConfig, AreaAnalyticsMetricConfig, AreaAnalyticsMetricFilter, AreaAnalyticsPalette, AreaAnalyticsRegionFillConfig, AreaAnalyticsRegionLineConfig, AreaAnalyticsRegionPolygonConfig, AreaAnalyticsScaleMode, BaseMapColorName, BaseMapKnob, BaseMapKnobId, BaseMapKnobValueOf, BeforeLayerConfig, BespokeSectionType, ByIdOrIndex, CSSCursor, ClearEventStateOptions, ClearEventStatesOptions, ClickEventType, CountryCrossingAlignment, CountryCrossingConfig, CountryCrossingFeature, CountryCrossingLabelConfig, CustomGeoJSONKnob, CustomGeoJSONKnobId, CustomGeoJSONKnobValueOf, CustomImage, DefaultPlaceIconConfig, DisplayCountryCrossing, DisplayCountryCrossingProps, DisplayCountryCrossings, DisplayRouteProps, DisplayRouteRelatedProps, DisplayRouteSummaries, DisplayRouteSummary, DisplayRouteSummaryProps, DisplayWaypoint, DrawnSectionType, EventHandlerConfig, EventHandlerCursorConfig, EventHandlerHoverConfig, EventScope, EventState, EventStateIds, EventType, ExtraFeatureProp, FeatureLabelConfig, FeaturePropValue, FilterablePOICategory, GeneratedSectionType, GeoJSONSourceClusterOptions, GeoJSONSourcesWithLayers, GeometriesKnob, GeometriesKnobId, GeometriesKnobValueOf, HasAdditionalLayersConfig, HasBeforeID, HillshadeColors, HillshadeLightAlignment, HillshadeLightConfig, HillshadeMethod, HoverEventType, HslColor, IconMapping, IndexedFeature, LabelConfig, LayerQuery, LayerSpecFilter, LayerSpecTemplate, LayerSpecWithSource, LightDark, MapColorName, MapColors, MapEventsConfig, MapFont, MapLibreOptions, MapModuleCommonConfig, MapPreset, MapPresetId, MapPresetSettings, MapStyleLayerID, MapStylePOICategory, POIIconConfig, POILabelConfig, POIsKnob, POIsKnobId, POIsKnobValueOf, POIsModuleConfig, POIsModuleFeature, PartsBeforeLayerConfig, PinIconConfig, PlaceClusterBadgeConfig, PlaceConnectionDisplay, PlaceConnectionLabelConfig, PlaceConnectionLayerName, PlaceConnectionsConfig, PlaceConnectionsLayersConfig, PlaceEntryPointFeature, PlaceEntryPointProps, PlaceEntryPointsConfig, PlaceEntryPointsLayersConfig, PlaceEntryPointsShowFor, PlaceIconConfig, PlaceLabelConfig, PlaceLayerName, PlaceLayersConfig, PlacesBeforeLayerConfig, PlacesClusterConfig, PlacesClusterSourceConfig, PlacesKnob, PlacesKnobId, PlacesKnobValueOf, PlacesMarkerType, PlacesModuleConfig, PlacesModuleSerializableConfig, PlanningWaypoint, RGBAColor, ReachableRangesKnob, ReachableRangesKnobId, ReachableRangesKnobValueOf, RenderedRef, ResolvedEventScope, RouteHighlightConfig, 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, SectionTypeWithKnob, SectionsDisplayConfig, SerializableCustomImage, SerializableFeatureLabelConfig, SerializablePinIconConfig, SetEventStateOptions, ShowOptions, SourceWithLayerIDs, SourceWithLayers, SourcesWithLayers, StandardStyle, StandardStyleID, StyleColorKnobId, StyleInput, StyleKnobId, StyleKnobValueOf, StyleLayerGroupName, StyleModuleLayerGroupName, StylePart, StyleSourcesWithLayers, StylingFoundationsKnob, StylingFoundationsKnobAppliesTo, StylingFoundationsKnobId, StylingFoundationsKnobKind, StylingFoundationsKnobRange, StylingFoundationsKnobValue, StylingFoundationsKnobValueOf, StylingFoundationsModuleConfig, SupportsEvents, TerrainElevationConfig, TerrainHillshadeConfig, TerrainKnob, TerrainKnobId, TerrainKnobValueOf, TerrainModuleConfig, ToBeAddedLayerSpec, ToBeAddedLayerSpecTemplate, ToBeAddedLayerSpecWithoutSource, TomTomMapParams, TrafficAreaAnalyticsKnob, TrafficAreaAnalyticsKnobId, TrafficAreaAnalyticsKnobValueOf, TrafficAreaAnalyticsLayersConfig, TrafficAreaAnalyticsModuleConfig, TrafficFlowKnob, TrafficFlowKnobId, TrafficFlowKnobValueOf, TrafficIncidentDetailsKnob, TrafficIncidentDetailsKnobId, TrafficIncidentDetailsKnobValueOf, TrafficIncidentsKnob, TrafficIncidentsKnobId, TrafficIncidentsKnobValueOf, UserEventHandler, WaypointDisplayProps, WaypointHighlightConfig, WaypointIconConfig, WaypointIndexType, WaypointLabelConfig, WaypointStopNumbering, WaypointsConfig };
+export type { AreaAnalyticsBeforeLayerConfig, AreaAnalyticsColorStop, AreaAnalyticsColorStopsConfig, AreaAnalyticsDisplayMode, AreaAnalyticsHeightConfig, AreaAnalyticsMetricConfig, AreaAnalyticsMetricFilter, AreaAnalyticsPalette, AreaAnalyticsRegionFillConfig, AreaAnalyticsRegionLineConfig, AreaAnalyticsRegionPolygonConfig, AreaAnalyticsScaleMode, BaseMapColorName, BaseMapKnob, BaseMapKnobId, BaseMapKnobValueOf, BeforeLayerConfig, BespokeSectionType, ByIdOrIndex, CSSCursor, ClearEventStateOptions, ClearEventStatesOptions, ClickEventType, CountryCrossingAlignment, CountryCrossingConfig, CountryCrossingFeature, CountryCrossingLabelConfig, CustomGeoJSONKnob, CustomGeoJSONKnobId, CustomGeoJSONKnobValueOf, CustomImage, CustomTypeface, CustomTypefaceFile, DefaultPlaceIconConfig, DisplayCountryCrossing, DisplayCountryCrossingProps, DisplayCountryCrossings, DisplayRouteProps, DisplayRouteRelatedProps, DisplayRouteSummaries, DisplayRouteSummary, DisplayRouteSummaryProps, DisplayWaypoint, DrawnSectionType, EventHandlerConfig, EventHandlerCursorConfig, EventHandlerHoverConfig, EventScope, EventState, EventStateIds, EventType, ExtraFeatureProp, FeatureLabelConfig, FeaturePropValue, FilterablePOICategory, GeneratedSectionType, GeoJSONSourceClusterOptions, GeoJSONSourcesWithLayers, GeometriesKnob, GeometriesKnobId, GeometriesKnobValueOf, HasAdditionalLayersConfig, HasBeforeID, HillshadeColors, HillshadeLightAlignment, HillshadeLightConfig, HillshadeMethod, HoverEventType, HslColor, IconMapping, IndexedFeature, LabelConfig, LayerQuery, LayerSpecFilter, LayerSpecTemplate, LayerSpecWithSource, LightDark, MapColorName, MapColors, MapEventsConfig, MapFont, MapLibreOptions, MapModuleCommonConfig, MapPreset, MapPresetId, MapPresetSettings, MapStyleLayerID, MapStylePOICategory, MapTypeface, POIIconConfig, POILabelConfig, POIsKnob, POIsKnobId, POIsKnobValueOf, POIsModuleConfig, POIsModuleFeature, PartsBeforeLayerConfig, PinIconConfig, PlaceClusterBadgeConfig, PlaceConnectionDisplay, PlaceConnectionLabelConfig, PlaceConnectionLayerName, PlaceConnectionsConfig, PlaceConnectionsLayersConfig, PlaceEntryPointFeature, PlaceEntryPointProps, PlaceEntryPointsConfig, PlaceEntryPointsLayersConfig, PlaceEntryPointsShowFor, PlaceIconConfig, PlaceLabelConfig, PlaceLayerName, PlaceLayersConfig, PlacesBeforeLayerConfig, PlacesClusterConfig, PlacesClusterSourceConfig, PlacesKnob, PlacesKnobId, PlacesKnobValueOf, PlacesMarkerType, PlacesModuleConfig, PlacesModuleSerializableConfig, PlanningWaypoint, RGBAColor, ReachableRangesKnob, ReachableRangesKnobId, ReachableRangesKnobValueOf, RenderedRef, ResolvedEventScope, RouteHighlightConfig, 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, SectionTypeWithKnob, SectionsDisplayConfig, SerializableCustomImage, SerializableFeatureLabelConfig, SerializablePinIconConfig, SetEventStateOptions, ShowOptions, SourceWithLayerIDs, SourceWithLayers, SourcesWithLayers, StandardStyle, StandardStyleID, StyleColorKnobId, StyleInput, StyleKnobId, StyleKnobValueOf, StyleLayerGroupName, StyleModuleLayerGroupName, StylePart, StyleSourcesWithLayers, StylingFoundationsKnob, StylingFoundationsKnobAppliesTo, StylingFoundationsKnobId, StylingFoundationsKnobKind, StylingFoundationsKnobRange, StylingFoundationsKnobValue, StylingFoundationsKnobValueOf, StylingFoundationsModuleConfig, SupportsEvents, TerrainElevationConfig, TerrainHillshadeConfig, TerrainKnob, TerrainKnobId, TerrainKnobValueOf, TerrainModuleConfig, ToBeAddedLayerSpec, ToBeAddedLayerSpecTemplate, ToBeAddedLayerSpecWithoutSource, TomTomMapParams, TrafficAreaAnalyticsKnob, TrafficAreaAnalyticsKnobId, TrafficAreaAnalyticsKnobValueOf, TrafficAreaAnalyticsLayersConfig, TrafficAreaAnalyticsModuleConfig, TrafficFlowKnob, TrafficFlowKnobId, TrafficFlowKnobValueOf, TrafficIncidentDetailsKnob, TrafficIncidentDetailsKnobId, TrafficIncidentDetailsKnobValueOf, TrafficIncidentsKnob, TrafficIncidentsKnobId, TrafficIncidentsKnobValueOf, UserEventHandler, WaypointDisplayProps, WaypointHighlightConfig, WaypointIconConfig, WaypointIndexType, WaypointLabelConfig, WaypointStopNumbering, WaypointsConfig };