@mapvx/web-js 1.1.1 → 1.1.2-dev.1

package/dist/umd/index.js

@@ -5721,13 +5721,17 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   AnnounceFormat: () => (/* reexport */ AnnounceFormat),
   Banner: () => (/* reexport */ Banner),
+  CIRCLE_DEFAULTS: () => (/* reexport */ CIRCLE_DEFAULTS),
   CacheManager: () => (/* reexport */ CacheManager),
   CountlyLogger: () => (/* reexport */ CountlyLogger),
   DEFAULT_CACHE_CONFIGS: () => (/* reexport */ DEFAULT_CACHE_CONFIGS),
   DEFAULT_MAX_STORAGE_BYTES: () => (/* reexport */ DEFAULT_MAX_STORAGE_BYTES),
+  DEFAULT_TILE_CACHE_CONFIG: () => (/* reexport */ DEFAULT_TILE_CACHE_CONFIG),
   FetchHttpClient: () => (/* reexport */ FetchHttpClient),
   Institution: () => (/* reexport */ Institution),
   LRUCache: () => (/* reexport */ LRUCache),
+  MAPLIBRE_MAX_TILE_CACHE_HARD_CAP: () => (/* reexport */ MAPLIBRE_MAX_TILE_CACHE_HARD_CAP),
+  MAPVX_BRAND_COLOR: () => (/* reexport */ MAPVX_BRAND_COLOR),
   MAPVX_DEFAULT_PRECONNECT_HOSTS: () => (/* reexport */ MAPVX_DEFAULT_PRECONNECT_HOSTS),
   MVXPlace: () => (/* reexport */ place_MVXPlace),
   MVXRoute: () => (/* reexport */ MVXRoute),
@@ -5739,18 +5743,119 @@ __webpack_require__.d(__webpack_exports__, {
   TextPosition: () => (/* reexport */ TextPosition),
   TransportationMode: () => (/* reexport */ TransportationMode),
   UnitSystem: () => (/* reexport */ UnitSystem),
+  circleRing: () => (/* reexport */ circleRing),
   createRouteAnimationIconDataUrl: () => (/* reexport */ createRouteAnimationIconDataUrl),
   initializeSDK: () => (/* reexport */ initializeSDK),
   injectPreconnects: () => (/* reexport */ injectPreconnects),
   isBasicWithIcon: () => (/* reexport */ isBasicWithIcon),
+  isBasicWithImageUrl: () => (/* reexport */ isBasicWithImageUrl),
   isBasicWithLogo: () => (/* reexport */ isBasicWithLogo),
   isMapVxRequestHostname: () => (/* reexport */ isMapVxRequestHostname),
+  isValidCircleConfig: () => (/* reexport */ isValidCircleConfig),
   loadCustomization: () => (/* reexport */ loadCustomization),
   loadStyles: () => (/* binding */ loadStyles)
 });
 
-;// ./src/infrastructure/cache/LRUCache.ts
+;// ./src/infrastructure/cache/cacheConfig.ts
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * Cache configuration types and defaults
+ * Defines the configuration options for the caching system
+ * @module cacheConfig
+ */
+
+/**
+ * Cache types available in the SDK
+ * @group Configuration
+ */
+
+/**
+ * Configuration for a single cache instance
+ * @group Configuration
+ */
+
+/**
+ * Configuration for the CacheManager
+ * @group Configuration
+ */
+
+/**
+ * Default maximum storage size: 5MB
+ */
+var DEFAULT_MAX_STORAGE_BYTES = 5 * 1024 * 1024;
+
+/**
+ * Default cache configurations per type
+ * These values balance memory usage with performance
+ */
+var DEFAULT_CACHE_CONFIGS = {
+  places: {
+    maxItems: 500,
+    ttlMs: 30 * 60 * 1000,
+    // 30 minutes
+    persistenceKey: "mvx_places"
+  },
+  routes: {
+    maxItems: 100,
+    ttlMs: 5 * 60 * 1000,
+    // 5 minutes
+    persistenceKey: "mvx_routes"
+  },
+  accessibleRoutes: {
+    maxItems: 100,
+    ttlMs: 5 * 60 * 1000,
+    // 5 minutes
+    persistenceKey: "mvx_accessible_routes"
+  },
+  configurations: {
+    maxItems: 10,
+    ttlMs: 60 * 60 * 1000,
+    // 1 hour
+    persistenceKey: "mvx_configurations"
+  },
+  categories: {
+    maxItems: 20,
+    ttlMs: 60 * 60 * 1000,
+    // 1 hour
+    persistenceKey: "mvx_categories"
+  },
+  vehicles: {
+    maxItems: 50,
+    ttlMs: 60 * 1000,
+    // 1 minute
+    persistenceKey: "mvx_vehicles"
+  },
+  stops: {
+    maxItems: 100,
+    ttlMs: 60 * 1000,
+    // 1 minute
+    persistenceKey: "mvx_stops"
+  },
+  subPlaces: {
+    maxItems: 200,
+    ttlMs: 15 * 60 * 1000,
+    // 15 minutes
+    persistenceKey: "mvx_subplaces"
+  }
+};
+
+/**
+ * Merges user config with defaults for a specific cache type
+ * @param cacheType - The type of cache
+ * @param userConfig - Optional user-provided configuration
+ * @returns Complete cache configuration
+ */
+function getCacheConfig(cacheType, userConfig) {
+  var defaultConfig = DEFAULT_CACHE_CONFIGS[cacheType];
+  return _objectSpread(_objectSpread({}, defaultConfig), userConfig);
+}
+;// ./src/infrastructure/cache/LRUCache.ts
+function LRUCache_typeof(o) { "@babel/helpers - typeof"; return LRUCache_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, LRUCache_typeof(o); }
 function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
@@ -5759,11 +5864,11 @@ function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol
 function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
-function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, LRUCache_toPropertyKey(o.key), o); } }
 function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
-function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
-function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function LRUCache_defineProperty(e, r, t) { return (r = LRUCache_toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function LRUCache_toPropertyKey(t) { var i = LRUCache_toPrimitive(t, "string"); return "symbol" == LRUCache_typeof(i) ? i : i + ""; }
+function LRUCache_toPrimitive(t, r) { if ("object" != LRUCache_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != LRUCache_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 /**
  * Internal cache entry structure
  */
@@ -5790,10 +5895,10 @@ var LRUCache = /*#__PURE__*/function () {
   function LRUCache(config) {
     _classCallCheck(this, LRUCache);
     // Hit rate tracking
-    _defineProperty(this, "hits", 0);
-    _defineProperty(this, "misses", 0);
+    LRUCache_defineProperty(this, "hits", 0);
+    LRUCache_defineProperty(this, "misses", 0);
     // Monotonic counter for LRU ordering (avoids issues with same-millisecond operations)
-    _defineProperty(this, "accessCounter", 0);
+    LRUCache_defineProperty(this, "accessCounter", 0);
     this.cache = new Map();
     this.maxItems = config.maxItems;
     this.ttlMs = config.ttlMs;
@@ -5961,104 +6066,6 @@ var LRUCache = /*#__PURE__*/function () {
     }
   }]);
 }();
-;// ./src/infrastructure/cache/cacheConfig.ts
-function cacheConfig_typeof(o) { "@babel/helpers - typeof"; return cacheConfig_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, cacheConfig_typeof(o); }
-function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { cacheConfig_defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-function cacheConfig_defineProperty(e, r, t) { return (r = cacheConfig_toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
-function cacheConfig_toPropertyKey(t) { var i = cacheConfig_toPrimitive(t, "string"); return "symbol" == cacheConfig_typeof(i) ? i : i + ""; }
-function cacheConfig_toPrimitive(t, r) { if ("object" != cacheConfig_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != cacheConfig_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-/**
- * Cache configuration types and defaults
- * Defines the configuration options for the caching system
- * @module cacheConfig
- */
-
-/**
- * Cache types available in the SDK
- * @group Configuration
- */
-
-/**
- * Configuration for a single cache instance
- * @group Configuration
- */
-
-/**
- * Configuration for the CacheManager
- * @group Configuration
- */
-
-/**
- * Default maximum storage size: 5MB
- */
-var DEFAULT_MAX_STORAGE_BYTES = 5 * 1024 * 1024;
-
-/**
- * Default cache configurations per type
- * These values balance memory usage with performance
- */
-var DEFAULT_CACHE_CONFIGS = {
-  places: {
-    maxItems: 500,
-    ttlMs: 30 * 60 * 1000,
-    // 30 minutes
-    persistenceKey: "mvx_places"
-  },
-  routes: {
-    maxItems: 100,
-    ttlMs: 5 * 60 * 1000,
-    // 5 minutes
-    persistenceKey: "mvx_routes"
-  },
-  accessibleRoutes: {
-    maxItems: 100,
-    ttlMs: 5 * 60 * 1000,
-    // 5 minutes
-    persistenceKey: "mvx_accessible_routes"
-  },
-  configurations: {
-    maxItems: 10,
-    ttlMs: 60 * 60 * 1000,
-    // 1 hour
-    persistenceKey: "mvx_configurations"
-  },
-  categories: {
-    maxItems: 20,
-    ttlMs: 60 * 60 * 1000,
-    // 1 hour
-    persistenceKey: "mvx_categories"
-  },
-  vehicles: {
-    maxItems: 50,
-    ttlMs: 60 * 1000,
-    // 1 minute
-    persistenceKey: "mvx_vehicles"
-  },
-  stops: {
-    maxItems: 100,
-    ttlMs: 60 * 1000,
-    // 1 minute
-    persistenceKey: "mvx_stops"
-  },
-  subPlaces: {
-    maxItems: 200,
-    ttlMs: 15 * 60 * 1000,
-    // 15 minutes
-    persistenceKey: "mvx_subplaces"
-  }
-};
-
-/**
- * Merges user config with defaults for a specific cache type
- * @param cacheType - The type of cache
- * @param userConfig - Optional user-provided configuration
- * @returns Complete cache configuration
- */
-function getCacheConfig(cacheType, userConfig) {
-  var defaultConfig = DEFAULT_CACHE_CONFIGS[cacheType];
-  return _objectSpread(_objectSpread({}, defaultConfig), userConfig);
-}
 ;// ./src/infrastructure/cache/PersistentCache.ts
 function PersistentCache_typeof(o) { "@babel/helpers - typeof"; return PersistentCache_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, PersistentCache_typeof(o); }
 function PersistentCache_createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = PersistentCache_unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
@@ -6786,13 +6793,16 @@ var countly_default = /*#__PURE__*/__webpack_require__.n(countly);
 var rollbar_umd_min = __webpack_require__(916);
 var rollbar_umd_min_default = /*#__PURE__*/__webpack_require__.n(rollbar_umd_min);
 ;// ./src/logger/rollbar.ts
-// VERSION is a webpack DefinePlugin constant, substituted only in the UMD
-// bundle. The tsc-built ES/CJS outputs keep it as a bare global, so the
-// typeof guard makes the lookup safe everywhere; the version placeholder is
-// replaced with the package version by scripts/inject-build-defines.js.
-var SDK_VERSION =  true ? "1.1.1" : 0;
+// VERSION and ROLLBAR_ACCESS_TOKEN are webpack DefinePlugin constants,
+// substituted only in the UMD bundle. The tsc-built ES/CJS outputs keep them
+// as bare globals, so the typeof guards make the lookup safe everywhere; the
+// version placeholder is replaced with the package version by
+// scripts/inject-build-defines.js. The access token falls back to the MapVX
+// SDK-web Rollbar project token when none is injected at build time.
+var SDK_VERSION =  true ? "1.1.2-dev.1" : 0;
+var ACCESS_TOKEN =  false ? 0 : "28279d52df43411ebd138c2bee0ab1df";
 var _rollbarConfig = {
-  accessToken: "28279d52df43411ebd138c2bee0ab1df",
+  accessToken: ACCESS_TOKEN,
   // Only report what the SDK logs explicitly via logError. Capturing every
   // uncaught error / unhandled rejection on the host page floods Rollbar
   // with items from third-party code (e.g. Countly, the host app itself)
@@ -6828,17 +6838,20 @@ function logger_toPrimitive(t, r) { if ("object" != logger_typeof(t) || !t) retu
 
 
 
+// DEBUG, VERSION and COUNTLY_KEY are webpack DefinePlugin constants,
+// substituted only in the UMD bundle. The tsc-built ES/CJS outputs keep them
+// as bare globals, so reading them directly throws ReferenceError in
+// consumers of those builds. The typeof guards make the lookup safe
+// everywhere; the version placeholder is replaced with the package version
+// by scripts/inject-build-defines.js. The Countly key falls back to the
+// MapVX key when none is injected at build time.
+var IS_DEBUG =  true ? false : 0;
+var logger_SDK_VERSION =  true ? "1.1.2-dev.1" : 0;
+var COUNTLY_API_KEY =  false ? 0 : "f0c8d3b96d336e857a8628f49dd1baf7d7add0e9";
 var logger_countly = {
-  apiKey: "f0c8d3b96d336e857a8628f49dd1baf7d7add0e9",
+  apiKey: COUNTLY_API_KEY,
   url: "https://countly.lazarillo.app"
 };
-// DEBUG and VERSION are webpack DefinePlugin constants, substituted only in
-// the UMD bundle. The tsc-built ES/CJS outputs keep them as bare globals, so
-// reading them directly throws ReferenceError in consumers of those builds.
-// The typeof guards make the lookup safe everywhere; the version placeholder
-// is replaced with the package version by scripts/inject-build-defines.js.
-var IS_DEBUG =  true ? false : 0;
-var logger_SDK_VERSION =  true ? "1.1.1" : 0;
 var Logger = /*#__PURE__*/function () {
   function Logger() {
     logger_classCallCheck(this, Logger);
@@ -7030,6 +7043,174 @@ var CountlyLogger = /*#__PURE__*/function () {
 // EXTERNAL MODULE: ./node_modules/.pnpm/maplibre-gl@5.7.0/node_modules/maplibre-gl/dist/maplibre-gl.js
 var maplibre_gl = __webpack_require__(997);
 var maplibre_gl_default = /*#__PURE__*/__webpack_require__.n(maplibre_gl);
+;// ./src/utils/semaphore.ts
+function semaphore_typeof(o) { "@babel/helpers - typeof"; return semaphore_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, semaphore_typeof(o); }
+function semaphore_classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function semaphore_defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, semaphore_toPropertyKey(o.key), o); } }
+function semaphore_createClass(e, r, t) { return r && semaphore_defineProperties(e.prototype, r), t && semaphore_defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function semaphore_defineProperty(e, r, t) { return (r = semaphore_toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function semaphore_toPropertyKey(t) { var i = semaphore_toPrimitive(t, "string"); return "symbol" == semaphore_typeof(i) ? i : i + ""; }
+function semaphore_toPrimitive(t, r) { if ("object" != semaphore_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != semaphore_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * Lower bound (inclusive) for the semaphore concurrency limit.
+ *
+ * A value of 1 means at least one operation can run at a time, which keeps the
+ * semaphore meaningful: zero or negative limits would deadlock every caller.
+ */
+var MIN_LIMIT = 1;
+
+/**
+ * Upper bound (inclusive) for the semaphore concurrency limit.
+ *
+ * 64 is high enough for any practical browser-side fan-out (network requests,
+ * tile fetches, etc.) while still protecting downstream services from being
+ * overwhelmed by misconfigured callers.
+ */
+var MAX_LIMIT = 64;
+
+/**
+ * Validate and normalize a candidate concurrency limit.
+ *
+ * @param limit - Candidate value to validate.
+ * @returns The validated integer limit, or `null` if the value is invalid.
+ */
+function normalizeLimit(limit) {
+  if (!Number.isFinite(limit)) return null;
+  var floored = Math.floor(limit);
+  if (floored < MIN_LIMIT || floored > MAX_LIMIT) return null;
+  return floored;
+}
+
+/**
+ * Counting semaphore that caps the number of concurrent operations.
+ *
+ * Useful when calling APIs, CDNs, or other shared resources where unbounded
+ * parallelism can trigger rate limiting, WAF blocks, or excessive memory use.
+ * Waiters are released in FIFO order as slots become free.
+ *
+ * @example
+ * ```typescript
+ * const sem = new Semaphore(4);
+ *
+ * async function fetchTile(url: string) {
+ *   await sem.acquire();
+ *   try {
+ *     return await fetch(url);
+ *   } finally {
+ *     sem.release();
+ *   }
+ * }
+ * ```
+ *
+ * @group Utils
+ */
+var Semaphore = /*#__PURE__*/function () {
+  /**
+   * @param limit - Maximum number of concurrent slots. Must be a finite
+   * integer in `[1, 64]`; invalid values fall back to `1`.
+   */
+  function Semaphore() {
+    var _normalizeLimit;
+    var limit = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : MIN_LIMIT;
+    semaphore_classCallCheck(this, Semaphore);
+    semaphore_defineProperty(this, "waiters", []);
+    semaphore_defineProperty(this, "slotsInUse", 0);
+    this.slotLimit = (_normalizeLimit = normalizeLimit(limit)) !== null && _normalizeLimit !== void 0 ? _normalizeLimit : MIN_LIMIT;
+  }
+
+  /**
+   * Maximum number of slots that can be acquired concurrently.
+   */
+  return semaphore_createClass(Semaphore, [{
+    key: "limit",
+    get: function get() {
+      return this.slotLimit;
+    }
+
+    /**
+     * Number of slots currently held by callers (acquired but not released).
+     */
+  }, {
+    key: "inUse",
+    get: function get() {
+      return this.slotsInUse;
+    }
+
+    /**
+     * Number of callers currently waiting for a slot.
+     */
+  }, {
+    key: "waiting",
+    get: function get() {
+      return this.waiters.length;
+    }
+
+    /**
+     * Acquire one slot. Resolves immediately if a slot is free; otherwise waits
+     * in FIFO order until `release()` is called.
+     *
+     * Every successful `acquire()` must be paired with exactly one `release()`,
+     * typically from a `finally` block. If the promise rejects (e.g. the optional
+     * `signal` aborts while queued) no slot was granted, so `release()` must NOT
+     * be called.
+     *
+     * @param signal - Optional `AbortSignal`. If it aborts while the caller is
+     * still queued, the waiter is removed from the queue and the promise rejects
+     * with an `AbortError`, so cancelled work never occupies a slot.
+     * @returns A promise that resolves once a slot has been granted.
+     */
+  }, {
+    key: "acquire",
+    value: function acquire(signal) {
+      var _this = this;
+      if (signal !== null && signal !== void 0 && signal.aborted) {
+        return Promise.reject(new DOMException("Aborted", "AbortError"));
+      }
+      if (this.slotsInUse < this.slotLimit) {
+        this.slotsInUse++;
+        return Promise.resolve();
+      }
+      return new Promise(function (resolve, reject) {
+        var waiter = function waiter() {
+          _this.slotsInUse++;
+          resolve();
+        };
+        _this.waiters.push(waiter);
+        if (signal) {
+          signal.addEventListener("abort", function () {
+            var index = _this.waiters.indexOf(waiter);
+            if (index !== -1) {
+              _this.waiters.splice(index, 1);
+              reject(new DOMException("Aborted", "AbortError"));
+            }
+          }, {
+            once: true
+          });
+        }
+      });
+    }
+
+    /**
+     * Release one slot, waking the next FIFO waiter only when a slot was actually
+     * freed.
+     *
+     * Safe to call even when no slots are in use: it is a true no-op in that case,
+     * so cleanup code in `finally` blocks is defensive against double-releases and
+     * a stray release can never admit a waiter beyond {@link limit}.
+     */
+  }, {
+    key: "release",
+    value: function release() {
+      if (this.slotsInUse > 0) {
+        this.slotsInUse--;
+        var next = this.waiters.shift();
+        if (next) {
+          next();
+        }
+      }
+    }
+  }]);
+}();
 ;// ./src/assets/icons.ts
 var userLocationDataUrl = "data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w3.org/2000/svg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20aria-hidden%3D%22false%22%20role%3D%22img%22%3E%3Ccircle%20cx%3D%2212%22%20cy%3D%2212%22%20r%3D%226%22%20fill%3D%22var(--icon-fill%2C%20%23007aff)%22%20stroke%3D%22var(--icon-stroke%2C%20%23ffffff)%22%20stroke-width%3D%222%22/%3E%3C/svg%3E";
 
@@ -7042,7 +7223,7 @@ var userLocationDataUrl = "data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w
  * Generates a data URL for the route animation icon SVG with customizable appearance.
  *
  * @param config - Optional configuration for the icon appearance.
- * @param config.backgroundColor - The background color of the circle (default: "#0076B6").
+ * @param config.backgroundColor - The background color of the circle (default: "#276EF1").
  * @param config.arrowColor - The color of the arrow (default: "#FFFFFF").
  * @param config.arrowWidth - The stroke width of the arrow path in pixels (default: 0).
  * @param config.borderWidth - The border width of the circle in pixels (default: 0).
@@ -7074,7 +7255,7 @@ var userLocationDataUrl = "data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w
  */
 function createRouteAnimationIconDataUrl(config) {
   var _config$backgroundCol, _config$arrowColor, _config$arrowWidth, _config$borderWidth, _config$borderColor, _config$blur;
-  var backgroundColor = (_config$backgroundCol = config === null || config === void 0 ? void 0 : config.backgroundColor) !== null && _config$backgroundCol !== void 0 ? _config$backgroundCol : "#0076B6";
+  var backgroundColor = (_config$backgroundCol = config === null || config === void 0 ? void 0 : config.backgroundColor) !== null && _config$backgroundCol !== void 0 ? _config$backgroundCol : "#276EF1";
   var arrowColor = (_config$arrowColor = config === null || config === void 0 ? void 0 : config.arrowColor) !== null && _config$arrowColor !== void 0 ? _config$arrowColor : "#FFFFFF";
   var arrowWidth = (_config$arrowWidth = config === null || config === void 0 ? void 0 : config.arrowWidth) !== null && _config$arrowWidth !== void 0 ? _config$arrowWidth : 0;
   var borderWidth = (_config$borderWidth = config === null || config === void 0 ? void 0 : config.borderWidth) !== null && _config$borderWidth !== void 0 ? _config$borderWidth : 0;
@@ -7093,7 +7274,7 @@ function createRouteAnimationIconDataUrl(config) {
   var filterId = blur > 0 ? "blurFilter" : "";
   var filterDef = blur > 0 ? "<defs><filter id=\"".concat(filterId, "\"><feGaussianBlur in=\"SourceGraphic\" stdDeviation=\"").concat(blur, "\"/></filter></defs>") : "";
   var filterAttr = blur > 0 ? "filter=\"url(#".concat(filterId, ")\"") : "";
-  var svg = "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<svg version=\"1.1\" id=\"Capa_1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" x=\"0px\" y=\"0px\"\n\t viewBox=\"0 0 40 40\" style=\"enable-background:new 0 0 40 40;\" xml:space=\"preserve\">\n".concat(filterDef, "\n<g ").concat(filterAttr, ">\n\t<circle cx=\"20\" cy=\"20\" r=\"20\" style=\"").concat(circleStyle).concat(circleStroke, "\"/>\n\t<path style=\"").concat(arrowStyle).concat(arrowStroke, "\" d=\"M12.4,29.7c-0.2,0.1-0.4,0.1-0.6,0.1c-0.2,0-0.4-0.1-0.5-0.3c-0.2-0.1-0.2-0.3-0.3-0.5c0-0.2,0-0.4,0.1-0.6\n\t\tl8.2-17.8c0.2-0.4,0.5-0.6,0.9-0.6c0.4,0,0.7,0.2,0.9,0.6l7.9,17.9c0.1,0.2,0.1,0.4,0.1,0.6c0,0.2-0.1,0.4-0.3,0.5\n\t\tc-0.1,0.1-0.3,0.2-0.5,0.3c-0.2,0-0.4,0-0.6-0.1L20,26.5L12.4,29.7z M13.9,27l6.1-2.6l6.1,2.7l-6-13.8L13.9,27z\"/>\n</g>\n</svg>");
+  var svg = "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<svg version=\"1.1\" id=\"Capa_1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" x=\"0px\" y=\"0px\"\n\t viewBox=\"0 0 30 30\" style=\"enable-background:new 0 0 30 30;\" xml:space=\"preserve\">\n".concat(filterDef, "\n<g ").concat(filterAttr, ">\n\t<circle cx=\"15\" cy=\"15\" r=\"15\" style=\"").concat(circleStyle).concat(circleStroke, "\"/>\n\t<path style=\"").concat(arrowStyle).concat(arrowStroke, "\" d=\"M16.4471 7.26386C16.2568 6.80696 15.808 6.51052 15.3131 6.51052C14.8181 6.51052 14.3693 6.80696 14.179 7.26386L8.52211 20.7533C8.29366 21.2972 8.48404 21.9227 8.97085 22.2518C9.45767 22.5809 10.1104 22.5156 10.5265 22.0995L15.3131 17.3129L20.0996 22.0995C20.5157 22.5156 21.1657 22.5782 21.6553 22.2518C22.1448 21.9254 22.3325 21.2972 22.104 20.7533L16.4471 7.26386Z\"/>\n</g>\n</svg>");
 
   // Encode the SVG as a data URL
   var encodedSvg = encodeURIComponent(svg);
@@ -7101,7 +7282,7 @@ function createRouteAnimationIconDataUrl(config) {
 }
 
 /**
- * Default route animation icon data URL with blue background (#0076B6) and white arrow (#FFFFFF).
+ * Default route animation icon data URL with blue background (#276EF1) and white arrow (#FFFFFF).
  * This constant is maintained for backward compatibility.
  *
  * @example
@@ -7223,6 +7404,10 @@ function getBoundingBox(points) {
   return [southwest, northeast];
 }
 ;// ./src/domain/models/marker.ts
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || marker_unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return marker_arrayLikeToArray(r); }
 function _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
 function _possibleConstructorReturn(t, e) { if (e && ("object" == marker_typeof(e) || "function" == typeof e)) return e; if (void 0 !== e) throw new TypeError("Derived constructors may only return object or undefined"); return _assertThisInitialized(t); }
 function _assertThisInitialized(e) { if (void 0 === e) throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); return e; }
@@ -7231,6 +7416,9 @@ function _getPrototypeOf(t) { return _getPrototypeOf = Object.setPrototypeOf ? O
 function _inherits(t, e) { if ("function" != typeof e && null !== e) throw new TypeError("Super expression must either be null or a function"); t.prototype = Object.create(e && e.prototype, { constructor: { value: t, writable: !0, configurable: !0 } }), Object.defineProperty(t, "prototype", { writable: !1 }), e && _setPrototypeOf(t, e); }
 function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
 function marker_typeof(o) { "@babel/helpers - typeof"; return marker_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, marker_typeof(o); }
+function marker_createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = marker_unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function marker_unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return marker_arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? marker_arrayLikeToArray(r, a) : void 0; } }
+function marker_arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function marker_classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
 function marker_defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, marker_toPropertyKey(o.key), o); } }
 function marker_createClass(e, r, t) { return r && marker_defineProperties(e.prototype, r), t && marker_defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
@@ -7334,82 +7522,104 @@ var MarkerUtils = /*#__PURE__*/function () {
      * ```
      */
     function createMarkerElement(marker) {
-      var _marker$iconPropertie, _marker$iconPropertie2, _marker$iconPropertie3, _marker$iconPropertie4;
       var markerContainer = document.createElement("div");
-
-      // Configure specific marker dimensions
-      var iconWidth = (_marker$iconPropertie = (_marker$iconPropertie2 = marker.iconProperties) === null || _marker$iconPropertie2 === void 0 ? void 0 : _marker$iconPropertie2.width) !== null && _marker$iconPropertie !== void 0 ? _marker$iconPropertie : 40;
-      var iconHeight = (_marker$iconPropertie3 = (_marker$iconPropertie4 = marker.iconProperties) === null || _marker$iconPropertie4 === void 0 ? void 0 : _marker$iconPropertie4.height) !== null && _marker$iconPropertie3 !== void 0 ? _marker$iconPropertie3 : 40;
-
-      // Apply base class
       markerContainer.className = "mapvx-marker";
-
-      // Configure classes and dimensions based on text presence
-      if (marker.text) {
-        // If text exists, adjust layout according to position
-        switch (marker.textPosition) {
-          case TextPosition.top:
-          case TextPosition.bottom:
-            markerContainer.classList.add("text-column");
-            markerContainer.style.width = "".concat(Math.max(iconWidth, 200), "px");
-            markerContainer.style.height = "auto";
-            break;
-          case TextPosition.left:
-          case TextPosition.right:
-          default:
-            markerContainer.classList.add("text-row");
-            markerContainer.style.width = "auto";
-            markerContainer.style.height = "".concat(iconHeight, "px");
-            break;
+      this.applyContainerLayout(markerContainer, marker);
+      var _iterator = marker_createForOfIteratorHelper(this.createMarkerChildren(marker)),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var child = _step.value;
+          markerContainer.appendChild(child);
         }
-      } else {
-        // No text, use fixed icon dimensions as in official example
-        markerContainer.classList.add("no-text");
-        markerContainer.style.width = "".concat(iconWidth, "px");
-        markerContainer.style.height = "".concat(iconHeight, "px");
-      }
-      markerContainer.addEventListener("click", function () {
-        var _marker$onClick;
-        (_marker$onClick = marker.onClick) === null || _marker$onClick === void 0 || _marker$onClick.call(marker);
-      });
-      if (marker.element) {
-        markerContainer.appendChild(marker.element);
-        return this.setAndCreateText(marker, markerContainer, "".concat(iconHeight, "px"), "".concat(iconWidth, "px"));
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
       }
+      return markerContainer;
+    }
 
-      // Create elements in correct order according to textPosition
-      var iconElement = this.createIconElement(marker, iconWidth, iconHeight);
-      var textElement = marker.text ? this.createTextContainer(typeof marker.text === "string" ? this.createTextElement(marker.text, marker.textProperties) : marker.text, marker.textPosition) : null;
+    /**
+     * Applies the marker container's own classes and box size from a config.
+     * Shared by {@link createMarkerElement} and {@link MarkerAttribute.updateIcon}
+     * so create and update stay in sync (single source of truth for which state
+     * classes exist and how the anchored box is sized). It is idempotent, so it
+     * also resets stale state when reused to update an existing element.
+     *
+     * @param container - The `.mapvx-marker` element to configure
+     * @param marker - Marker configuration
+     */
+  }, {
+    key: "applyContainerLayout",
+    value: function applyContainerLayout(container, marker) {
+      // Reset the state classes we own (no-op on a fresh element).
+      container.classList.remove("no-text", "interactive");
 
-      // Add elements in correct order
-      if (marker.textPosition === TextPosition.top || marker.textPosition === TextPosition.left) {
-        if (textElement) markerContainer.appendChild(textElement);
-        markerContainer.appendChild(iconElement);
+      // The container box equals the icon box so the out-of-flow label never
+      // displaces the icon from the coordinate MapLibre anchors. A caller-
+      // provided `element` owns its own size, so we let the box size to it.
+      if (marker.element) {
+        container.style.width = "";
+        container.style.height = "";
       } else {
-        markerContainer.appendChild(iconElement);
-        if (textElement) markerContainer.appendChild(textElement);
+        var _marker$iconPropertie, _marker$iconPropertie2, _marker$iconPropertie3, _marker$iconPropertie4;
+        var iconWidth = (_marker$iconPropertie = (_marker$iconPropertie2 = marker.iconProperties) === null || _marker$iconPropertie2 === void 0 ? void 0 : _marker$iconPropertie2.width) !== null && _marker$iconPropertie !== void 0 ? _marker$iconPropertie : 40;
+        var iconHeight = (_marker$iconPropertie3 = (_marker$iconPropertie4 = marker.iconProperties) === null || _marker$iconPropertie4 === void 0 ? void 0 : _marker$iconPropertie4.height) !== null && _marker$iconPropertie3 !== void 0 ? _marker$iconPropertie3 : 40;
+        container.style.width = "".concat(iconWidth, "px");
+        container.style.height = "".concat(iconHeight, "px");
+      }
+      if (!marker.text) {
+        container.classList.add("no-text");
+      }
+
+      // Only flag the marker interactive when it actually handles clicks: this
+      // flips the out-of-flow label's pointer-events to auto (see styles.css)
+      // so the label is hit-testable, while non-clickable labels stay
+      // click-through and never block the map.
+      if (marker.onClick) {
+        container.classList.add("interactive");
       }
-      return markerContainer;
     }
 
     /**
-     * Sets up text positioning and styling for the marker.
+     * Builds the in-order children for a marker container: the icon (or the
+     * caller-provided element) followed by the optional out-of-flow label. DOM
+     * order is irrelevant for placement — the .text-container position classes
+     * (top/bottom/left/right) lay the label out around the icon.
      *
-     * @param markerConfig - Configuration object containing text properties
-     * @param container - Container element where text will be added
-     * @param iconHeight - Height of the icon for positioning calculations
-     * @param iconWidth - Width of the icon for positioning calculations
-     * @returns Container element with properly positioned text
+     * @param marker - Marker configuration
+     * @returns The child elements to append to the container
      */
   }, {
-    key: "setAndCreateText",
-    value: function setAndCreateText(markerConfig, container, iconHeight, iconWidth) {
-      if (markerConfig.text) {
-        var textElement = typeof markerConfig.text === "string" ? this.createTextElement(markerConfig.text, markerConfig.textProperties) : markerConfig.text;
-        var textContainer = this.createTextContainer(textElement, markerConfig.textPosition);
-        container.appendChild(textContainer);
+    key: "createMarkerChildren",
+    value: function createMarkerChildren(marker) {
+      var children = [];
+      if (marker.element) {
+        children.push(marker.element);
+      } else {
+        var _marker$iconPropertie5, _marker$iconPropertie6, _marker$iconPropertie7, _marker$iconPropertie8;
+        var iconWidth = (_marker$iconPropertie5 = (_marker$iconPropertie6 = marker.iconProperties) === null || _marker$iconPropertie6 === void 0 ? void 0 : _marker$iconPropertie6.width) !== null && _marker$iconPropertie5 !== void 0 ? _marker$iconPropertie5 : 40;
+        var iconHeight = (_marker$iconPropertie7 = (_marker$iconPropertie8 = marker.iconProperties) === null || _marker$iconPropertie8 === void 0 ? void 0 : _marker$iconPropertie8.height) !== null && _marker$iconPropertie7 !== void 0 ? _marker$iconPropertie7 : 40;
+        children.push(this.createIconElement(marker, iconWidth, iconHeight));
       }
-      return container;
+      if (marker.text) {
+        children.push(this.buildTextContainer(marker));
+      }
+      return children;
+    }
+
+    /**
+     * Builds the positioned label container for a marker.
+     *
+     * @param marker - Marker configuration; `text` is assumed to be set
+     * @returns The `.text-container` element ready to append
+     */
+  }, {
+    key: "buildTextContainer",
+    value: function buildTextContainer(marker) {
+      var textElement = typeof marker.text === "string" ? this.createTextElement(marker.text, marker.textProperties) : marker.text;
+      return this.createTextContainer(textElement, marker.textPosition);
     }
 
     /**
@@ -7443,7 +7653,8 @@ var MarkerUtils = /*#__PURE__*/function () {
 
     /**
      * Creates a text container with proper positioning using CSS classes.
-     * Uses natural block/flex layout without absolute positioning.
+     * The container is absolutely positioned (out of flow) so the label
+     * never grows the marker's anchored box.
      *
      * @param textElement - The text element to contain
      * @param textPosition - Desired position relative to the icon
@@ -7495,11 +7706,11 @@ var MarkerUtils = /*#__PURE__*/function () {
   }, {
     key: "createIcon",
     value: function createIcon(marker) {
-      var _marker$iconPropertie5, _marker$iconPropertie6, _marker$iconPropertie7, _marker$iconPropertie8;
+      var _marker$iconPropertie9, _marker$iconPropertie0, _marker$iconPropertie1, _marker$iconPropertie10;
       var image = document.createElement("img");
       image.src = typeof marker.icon == "string" ? marker.icon : "";
-      image.width = (_marker$iconPropertie5 = (_marker$iconPropertie6 = marker.iconProperties) === null || _marker$iconPropertie6 === void 0 ? void 0 : _marker$iconPropertie6.width) !== null && _marker$iconPropertie5 !== void 0 ? _marker$iconPropertie5 : 40;
-      image.height = (_marker$iconPropertie7 = (_marker$iconPropertie8 = marker.iconProperties) === null || _marker$iconPropertie8 === void 0 ? void 0 : _marker$iconPropertie8.height) !== null && _marker$iconPropertie7 !== void 0 ? _marker$iconPropertie7 : 40;
+      image.width = (_marker$iconPropertie9 = (_marker$iconPropertie0 = marker.iconProperties) === null || _marker$iconPropertie0 === void 0 ? void 0 : _marker$iconPropertie0.width) !== null && _marker$iconPropertie9 !== void 0 ? _marker$iconPropertie9 : 40;
+      image.height = (_marker$iconPropertie1 = (_marker$iconPropertie10 = marker.iconProperties) === null || _marker$iconPropertie10 === void 0 ? void 0 : _marker$iconPropertie10.height) !== null && _marker$iconPropertie1 !== void 0 ? _marker$iconPropertie1 : 40;
       image.style.objectFit = "contain";
       image.style.filter = "drop-shadow(0px 4px 4px rgba(0, 0, 0, 0.25))";
       return image;
@@ -7568,6 +7779,12 @@ var MarkerAttribute = /*#__PURE__*/function (_Marker) {
    * Used for indoor navigation and floor-specific marker management.
    */
 
+  /**
+   * Current click handler for the marker. Stored on the instance (rather than
+   * captured in the DOM listener's closure) so {@link updateIcon} can swap it
+   * without leaving the original handler attached to MapLibre's element.
+   */
+
   /**
    * Constructs a new `MarkerAttribute` object with the specified properties.
    *
@@ -7593,6 +7810,14 @@ var MarkerAttribute = /*#__PURE__*/function (_Marker) {
       anchor: (_markerConfig$anchor = markerConfig.anchor) !== null && _markerConfig$anchor !== void 0 ? _markerConfig$anchor : "center",
       offset: [0, 0]
     }]);
+
+    // Route clicks through an instance-level handler so the latest onClick is
+    // always invoked, even after updateIcon replaces the marker content.
+    _this._userOnClick = markerConfig.onClick;
+    _this._element.addEventListener("click", function () {
+      var _this$_userOnClick, _this2;
+      return (_this$_userOnClick = (_this2 = _this)._userOnClick) === null || _this$_userOnClick === void 0 ? void 0 : _this$_userOnClick.call(_this2);
+    });
     _this.setLngLat([markerConfig.coordinate.lng, markerConfig.coordinate.lat]);
     _this.setRotationAlignment((_markerConfig$rotatio = markerConfig.rotationAlignment) !== null && _markerConfig$rotatio !== void 0 ? _markerConfig$rotatio : "viewport");
     _this.setPitchAlignment("viewport");
@@ -7640,19 +7865,16 @@ var MarkerAttribute = /*#__PURE__*/function (_Marker) {
   }, {
     key: "updateIcon",
     value: function updateIcon(marker) {
-      var _marker$rotationAlign;
-      if (marker.element) {
-        this._element.innerHTML = "";
-        this._element.appendChild(marker.element);
-      } else {
-        var markerElement = MarkerUtils.createMarkerElement(marker);
-        var oldMarkerContent = this._element.querySelector("div");
-        var newMarkerContent = markerElement.querySelector("div");
-        if (newMarkerContent) {
-          var _oldMarkerContent$par;
-          oldMarkerContent === null || oldMarkerContent === void 0 || (_oldMarkerContent$par = oldMarkerContent.parentElement) === null || _oldMarkerContent$par === void 0 || _oldMarkerContent$par.replaceChild(newMarkerContent, oldMarkerContent);
-        }
-      }
+      var _this$_element, _marker$rotationAlign;
+      // Reconfigure the element MapLibre already holds in place, rather than
+      // building a throwaway element and grafting pieces of it. MapLibre owns the
+      // element's other classes and inline styles (transform, position), which
+      // must survive the update; we only reset our own classes/size and swap the
+      // children. Both create and update go through the same MarkerUtils helpers,
+      // so they cannot drift apart.
+      MarkerUtils.applyContainerLayout(this._element, marker);
+      (_this$_element = this._element).replaceChildren.apply(_this$_element, _toConsumableArray(MarkerUtils.createMarkerChildren(marker)));
+      this._userOnClick = marker.onClick;
       this.setRotationAlignment((_marker$rotationAlign = marker.rotationAlignment) !== null && _marker$rotationAlign !== void 0 ? _marker$rotationAlign : "viewport");
       this.setPitchAlignment("viewport");
       if (typeof marker.rotation === "number") {
@@ -7734,6 +7956,52 @@ var MarkerAttribute = /*#__PURE__*/function (_Marker) {
     }
   }]);
 }(maplibre_gl.Marker);
+;// ./src/domain/models/routeInstance.ts
+/**
+ * Represents the conditions for the step animation.
+ * @group Routes
+ */
+
+/**
+ * Represents a single route instance on the map with its own
+ * MapLibre sources/layers, GeoJSON data, animation state, and marker.
+ * @group Routes
+ */
+
+/**
+ * Creates a new RouteInstance from a route.
+ * Each instance gets unique MapLibre source/layer IDs based on the route's UUID.
+ * @param route The route to create an instance for.
+ * @returns A new RouteInstance with initialized GeoJSON data structures.
+ * @group Routes
+ */
+function createRouteInstance(route) {
+  return {
+    id: route.id,
+    route: route,
+    aheadId: "AHEAD_".concat(route.id),
+    behindId: "BEHIND_".concat(route.id),
+    currentId: "CURRENT_".concat(route.id),
+    aheadSourceData: {
+      type: "FeatureCollection",
+      features: []
+    },
+    behindSourceData: {
+      type: "FeatureCollection",
+      features: []
+    },
+    currentSourceData: {
+      type: "Feature",
+      properties: {},
+      geometry: {
+        type: "LineString",
+        coordinates: []
+      }
+    },
+    animationStatus: "NO_ROUTE",
+    stepAnimationStatus: "NO_ROUTE"
+  };
+}
 ;// ./src/utils/nav-functions.ts
 function nav_functions_typeof(o) { "@babel/helpers - typeof"; return nav_functions_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, nav_functions_typeof(o); }
 function nav_functions_classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
@@ -7913,60 +8181,14 @@ var NavFunctions = /*#__PURE__*/function () {
  * The radius of the Earth in meters.
  */
 nav_functions_defineProperty(NavFunctions, "EARTH_RADIUS", 6378000);
-;// ./src/domain/models/routeInstance.ts
-/**
- * Represents the conditions for the step animation.
- * @group Routes
- */
-
-/**
- * Represents a single route instance on the map with its own
- * MapLibre sources/layers, GeoJSON data, animation state, and marker.
- * @group Routes
- */
-
-/**
- * Creates a new RouteInstance from a route.
- * Each instance gets unique MapLibre source/layer IDs based on the route's UUID.
- * @param route The route to create an instance for.
- * @returns A new RouteInstance with initialized GeoJSON data structures.
- * @group Routes
- */
-function createRouteInstance(route) {
-  return {
-    id: route.id,
-    route: route,
-    aheadId: "AHEAD_".concat(route.id),
-    behindId: "BEHIND_".concat(route.id),
-    currentId: "CURRENT_".concat(route.id),
-    aheadSourceData: {
-      type: "FeatureCollection",
-      features: []
-    },
-    behindSourceData: {
-      type: "FeatureCollection",
-      features: []
-    },
-    currentSourceData: {
-      type: "Feature",
-      properties: {},
-      geometry: {
-        type: "LineString",
-        coordinates: []
-      }
-    },
-    animationStatus: "NO_ROUTE",
-    stepAnimationStatus: "NO_ROUTE"
-  };
-}
 ;// ./src/controllers/routeController.ts
 function routeController_typeof(o) { "@babel/helpers - typeof"; return routeController_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, routeController_typeof(o); }
 function routeController_ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function routeController_objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? routeController_ownKeys(Object(t), !0).forEach(function (r) { routeController_defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : routeController_ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || routeController_unsupportedIterableToArray(r) || _nonIterableSpread(); }
-function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
-function _arrayWithoutHoles(r) { if (Array.isArray(r)) return routeController_arrayLikeToArray(r); }
+function routeController_toConsumableArray(r) { return routeController_arrayWithoutHoles(r) || routeController_iterableToArray(r) || routeController_unsupportedIterableToArray(r) || routeController_nonIterableSpread(); }
+function routeController_nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function routeController_iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function routeController_arrayWithoutHoles(r) { if (Array.isArray(r)) return routeController_arrayLikeToArray(r); }
 function routeController_createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = routeController_unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
 function routeController_unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return routeController_arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? routeController_arrayLikeToArray(r, a) : void 0; } }
 function routeController_arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
@@ -8341,7 +8563,7 @@ var RouteController = /*#__PURE__*/function () {
           throw new Error("Error: position array has different length than colors array");
         }
         var stops = createStops(positionsToUse, colors);
-        var gradient = ["interpolate", ["linear"], ["line-progress"]].concat(_toConsumableArray(stops));
+        var gradient = ["interpolate", ["linear"], ["line-progress"]].concat(routeController_toConsumableArray(stops));
         return {
           "line-color": null,
           "line-gradient": gradient,
@@ -8588,7 +8810,7 @@ var RouteController = /*#__PURE__*/function () {
       this.removeSourcesAndLayersForRoute(instance);
       this.routes["delete"](instance.id);
       if (this.lastAddedRouteId === instance.id) {
-        var remaining = _toConsumableArray(this.routes.keys());
+        var remaining = routeController_toConsumableArray(this.routes.keys());
         this.lastAddedRouteId = remaining.length > 0 ? remaining[remaining.length - 1] : undefined;
       }
     }
@@ -8623,7 +8845,7 @@ var RouteController = /*#__PURE__*/function () {
   }, {
     key: "getRouteIds",
     value: function getRouteIds() {
-      return _toConsumableArray(this.routes.keys());
+      return routeController_toConsumableArray(this.routes.keys());
     }
   }, {
     key: "internalPause",
@@ -9132,6 +9354,27 @@ var RouteController = /*#__PURE__*/function () {
             return;
           }
         }
+        if (step.startInsideFloor !== step.endInsideFloor) {
+          if (waitStartTime == null) {
+            instance.conditions.waitStartTime = timestamp;
+            instance.conditions.animationId = requestAnimationFrame(function (time) {
+              return _this8.animateStep(time, instance);
+            });
+            return;
+          }
+          if (timestamp - waitStartTime < changeFloorTime * 1000) {
+            instance.conditions.animationId = requestAnimationFrame(function (time) {
+              return _this8.animateStep(time, instance);
+            });
+            return;
+          } else {
+            this.updatePlaceFloorForRouting(instance, step.endInsidePlace, step.endInsideFloor);
+            this.setMarkerLngLat(instance, step.endLocation);
+            instance.conditions.waitStartTime = undefined;
+            onFinish === null || onFinish === void 0 || onFinish(timestamp);
+            return;
+          }
+        }
         var distance = NavFunctions.distance(start, end);
         var speed = Math.max(step.distance / stepTime, minimumSpeed !== null && minimumSpeed !== void 0 ? minimumSpeed : 0);
         if (speed * progressInSeconds > distance) {
@@ -9157,26 +9400,6 @@ var RouteController = /*#__PURE__*/function () {
               return _this8.animateStep(time, instance);
             });
             return;
-          } else if (step.startInsideFloor !== step.endInsideFloor) {
-            if (waitStartTime == null) {
-              instance.conditions.waitStartTime = timestamp;
-              instance.conditions.animationId = requestAnimationFrame(function (time) {
-                return _this8.animateStep(time, instance);
-              });
-              return;
-            }
-            if (timestamp - waitStartTime < changeFloorTime * 1000) {
-              instance.conditions.animationId = requestAnimationFrame(function (time) {
-                return _this8.animateStep(time, instance);
-              });
-              return;
-            } else {
-              this.updatePlaceFloorForRouting(instance, step.endInsidePlace, step.endInsideFloor);
-              this.setMarkerLngLat(instance, step.endLocation);
-              instance.conditions.waitStartTime = undefined;
-              onFinish === null || onFinish === void 0 || onFinish(timestamp);
-              return;
-            }
           } else {
             onFinish === null || onFinish === void 0 || onFinish(timestamp);
             return;
@@ -9310,9 +9533,10 @@ var InternalGetRouteConfiguration = /*#__PURE__*/routeConfiguration_createClass(
  * @param language The language for the instructions.
  * @param unitSystem The unit system used for the distance.
  * @param announceFormat The format used to announce directions in the instructions.
+ * @param userBearing The user's heading in degrees used as the reference direction for announcing turns.
  */
 function InternalGetRouteConfiguration(config) {
-  var _config$preferAccessi, _config$language, _config$unitSystem, _config$announceForma;
+  var _config$preferAccessi, _config$language, _config$unitSystem, _config$announceForma, _config$userBearing;
   routeConfiguration_classCallCheck(this, InternalGetRouteConfiguration);
   this.initialLocation = config.initialLocation;
   this.finalLocation = config.finalLocation;
@@ -9320,6 +9544,7 @@ function InternalGetRouteConfiguration(config) {
   this.language = (_config$language = config.language) !== null && _config$language !== void 0 ? _config$language : "en";
   this.unitSystem = (_config$unitSystem = config.unitSystem) !== null && _config$unitSystem !== void 0 ? _config$unitSystem : UnitSystem.metric;
   this.announceFormat = (_config$announceForma = config.announceFormat) !== null && _config$announceForma !== void 0 ? _config$announceForma : AnnounceFormat.relative;
+  this.userBearing = (_config$userBearing = config.userBearing) !== null && _config$userBearing !== void 0 ? _config$userBearing : 0;
 });
 
 /**
@@ -9350,6 +9575,16 @@ function InternalDrawRouteConfiguration(config) {
 /**
  * Interface that represent a place with their id.
  * @group Routes
+ * @example
+ * ```typescript
+ * // Resolve an internal alias that is reused across several malls by
+ * // pinning the building (and, optionally, the floor) it belongs to.
+ * const origin: IdLocation = {
+ *   id: "store-204",      // integrator alias, may repeat across buildings
+ *   buildingId: "mall-santiago",
+ *   floorId: "level-2",   // takes precedence over `level`
+ * }
+ * ```
  */
 
 /**
@@ -9404,11 +9639,11 @@ var InternalAnimationDrawingConfig = /*#__PURE__*/function () {
     animation_classCallCheck(this, InternalAnimationDrawingConfig);
     this.aheadPathStyle = (_data$aheadPathStyle = data.aheadPathStyle) !== null && _data$aheadPathStyle !== void 0 ? _data$aheadPathStyle : {
       type: "Solid",
-      color: "#757575"
+      color: "#0C0C0C"
     };
     this.behindPathStyle = (_data$behindPathStyle = data.behindPathStyle) !== null && _data$behindPathStyle !== void 0 ? _data$behindPathStyle : {
       type: "Solid",
-      color: "#0076B6"
+      color: "#276EF1"
     };
     this.polylineWidth = (_data$polylineWidth = data.polylineWidth) !== null && _data$polylineWidth !== void 0 ? _data$polylineWidth : 10;
     if (data.routeIcon != null) {
@@ -9562,7 +9797,8 @@ var Loggeable = /*#__PURE__*/function () {
  *   maxTiles: 500,
  *   ttlMs: 60 * 60 * 1000, // 1 hour
  *   persistToServiceWorker: true,
- *   preloadAdjacentZooms: false
+ *   preloadAdjacentZooms: false,
+ *   maxConcurrentTileFetches: 6
  * };
  * ```
  *
@@ -9579,9 +9815,19 @@ var DEFAULT_TILE_CACHE_CONFIG = {
   ttlMs: 30 * 60 * 1000,
   // 30 minutes
   persistToServiceWorker: true,
-  preloadAdjacentZooms: false
+  preloadAdjacentZooms: false,
+  maxConcurrentTileFetches: 6
 };
 
+/**
+ * Hard cap for {@link MapTileCacheConfig.maxTiles}.
+ * Configurations above this (e.g. millions) are clamped to avoid memory pressure
+ * and excessive interaction with the tile CDN / service worker.
+ *
+ * @internal
+ */
+var MAPLIBRE_MAX_TILE_CACHE_HARD_CAP = 100000;
+
 /**
  * Basic configuration for the map.
  * Provides essential settings for initializing and customizing map behavior.
@@ -9619,11 +9865,298 @@ var DEFAULT_TILE_CACHE_CONFIG = {
  * @property showZoom - (Optional) Whether to display the zoom control.
  * @property navigationPosition - (Optional) Position of the navigation controls on the map.
  * @property bearingSnap - (Optional) The bearing snap threshold in degrees.
+ * @property bearing - (Optional) Initial bearing (rotation) of the map in degrees, clockwise from north.
+ * @property interactive - (Optional) Master switch for all user interaction (pan/zoom/rotate).
+ * @property rotateEnabled - (Optional) Whether the user can rotate the map; keeps pinch-zoom when disabled.
+ * @property dragPan - (Optional) Whether the user can pan by dragging/swiping.
+ * @property scrollZoom - (Optional) Whether the scroll wheel/trackpad can zoom the map.
+ * @property doubleClickZoom - (Optional) Whether double-click/double-tap zooms the map.
+ * @property touchZoomRotate - (Optional) Whether pinch gestures can zoom the map on touch devices.
+ * @property keyboard - (Optional) Whether keyboard shortcuts can pan/zoom/rotate the map.
  * @property institutionId - (Optional) The institution identifier for map context. Required for loading map related data from Portal.
  * @property authToken - (Optional) Authentication token for accessing protected map resources. Required for loading map related data from Portal.
  * @property apiUrl - (Optional) Injected by SDK when creating map; base API URL for map requests.
  * @property mapvxRequestContext - (Optional) Injected by SDK when creating map; context sent as headers to public-api.mapvx.com.
  */
+;// ./src/domain/models/circle.ts
+function circle_typeof(o) { "@babel/helpers - typeof"; return circle_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, circle_typeof(o); }
+function circle_ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function circle_objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? circle_ownKeys(Object(t), !0).forEach(function (r) { circle_defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : circle_ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function circle_defineProperty(e, r, t) { return (r = circle_toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function circle_toPropertyKey(t) { var i = circle_toPrimitive(t, "string"); return "symbol" == circle_typeof(i) ? i : i + ""; }
+function circle_toPrimitive(t, r) { if ("object" != circle_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != circle_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+
+/**
+ * MapVX brand color used as the default for circle styling and other
+ * SDK-drawn overlays (colored places, borders).
+ *
+ * @group Circles
+ */
+var MAPVX_BRAND_COLOR = "#276EF1";
+
+/**
+ * Where a circle renders relative to the other map layers.
+ *
+ * - `"aboveBasemap"` (default): above every basemap geometry layer —
+ *   including indoor floor-plate and building polygons — but below the
+ *   labels that follow them. A circle is never occluded by basemap fills.
+ * - `"belowLabels"`: below the first symbol (label) layer of the style.
+ *   On indoor styles, floor-plate polygons ordered after that layer will
+ *   paint over the circle.
+ * - `"top"`: above everything, including labels and markers drawn in
+ *   style layers.
+ *
+ * @group Circles
+ */
+
+/**
+ * Valid values for {@link CircleRenderOrder}, in rendering order.
+ * @internal
+ */
+var CIRCLE_RENDER_ORDERS = ["belowLabels", "aboveBasemap", "top"];
+
+/**
+ * Default styling values applied to a circle when the corresponding
+ * {@link CircleConfig} fields are omitted.
+ *
+ * @group Circles
+ */
+var CIRCLE_DEFAULTS = {
+  fillColor: MAPVX_BRAND_COLOR,
+  fillOpacity: 0.14,
+  strokeColor: MAPVX_BRAND_COLOR,
+  strokeWidth: 2,
+  strokeOpacity: 0.65,
+  renderOrder: "aboveBasemap"
+};
+
+/**
+ * Represents the configuration for the creation of a metric radius circle on a map.
+ * The radius is expressed in meters (geographic), so the drawn circle stays
+ * metrically accurate at every zoom level.
+ *
+ * @example
+ * ```typescript
+ * const circleConfig: CircleConfig = {
+ *   id: "geofence-1",
+ *   coordinate: { lat: 40.7128, lng: -74.0060 },
+ *   radiusMeters: 150,
+ *   fillOpacity: 0.2,
+ * };
+ * ```
+ *
+ * @group Circles
+ */
+
+/**
+ * Internal resolved representation of a circle kept by the map.
+ * Holds the full configuration with defaults applied, plus visibility state.
+ *
+ * Unlike markers, the hidden flag persists across floor changes and map
+ * restyles: a circle hidden via `hideCircle` stays hidden until `showCircle`.
+ */
+
+/**
+ * Returns a deep copy of a {@link CircleRecord}, including the nested
+ * coordinate. Used by the map accessors so callers can't mutate internal
+ * circle state by writing to a returned record.
+ *
+ * @param record The circle record to clone.
+ * @returns An independent copy of the record.
+ *
+ * @group Circles
+ */
+function cloneCircleRecord(record) {
+  return circle_objectSpread(circle_objectSpread({}, record), {}, {
+    coordinate: circle_objectSpread({}, record.coordinate)
+  });
+}
+
+/**
+ * Validates that a radius in meters is positive and finite.
+ * @param radius The radius value to validate.
+ * @throws {Error} If radius is ≤ 0 or not finite (NaN/Infinity).
+ * @internal
+ */
+function validateRadiusMeters(radius) {
+  if (!Number.isFinite(radius) || radius <= 0) {
+    throw new Error("Invalid radiusMeters: ".concat(radius, ". Must be a positive finite number."));
+  }
+}
+
+/**
+ * Validates that a coordinate is within valid geographic bounds.
+ * @param coord The coordinate to validate.
+ * @throws {Error} If latitude is outside [-90, 90] or longitude outside [-180, 180], or not finite.
+ * @internal
+ */
+function validateCoordinate(coord) {
+  if (coord == null || circle_typeof(coord) !== "object") {
+    throw new Error("Invalid coordinate: expected an object with lat and lng properties.");
+  }
+  if (!Number.isFinite(coord.lat) || !Number.isFinite(coord.lng) || coord.lat < -90 || coord.lat > 90 || coord.lng < -180 || coord.lng > 180) {
+    throw new Error("Invalid coordinate: lat=".concat(coord.lat, ", lng=").concat(coord.lng, ". ") + "latitude must be in [-90, 90], longitude in [-180, 180], and both finite.");
+  }
+}
+
+/**
+ * Clamps an opacity value to the valid range [0, 1].
+ * @param opacity The opacity value to clamp.
+ * @param defaultValue Value to use if opacity is not a finite number.
+ * @returns The clamped opacity value.
+ * @internal
+ */
+function clampOpacity(opacity, defaultValue) {
+  if (!Number.isFinite(opacity)) return defaultValue;
+  return Math.max(0, Math.min(1, opacity));
+}
+
+/**
+ * Type guard for validating circle configurations without throwing.
+ * Returns true if the configuration is valid and can be added to the map.
+ *
+ * @param config Configuration to validate.
+ * @returns True if config is a valid CircleConfig, false otherwise.
+ *
+ * @example
+ * ```typescript
+ * if (isValidCircleConfig(userInput)) {
+ *   map.addCircle(userInput);
+ * } else {
+ *   console.error('Invalid circle configuration');
+ * }
+ * ```
+ *
+ * @group Circles
+ */
+function isValidCircleConfig(config) {
+  if (config === null || config === undefined || circle_typeof(config) !== "object") {
+    return false;
+  }
+  var c = config;
+  if (circle_typeof(c.coordinate) !== "object" || c.coordinate === null) return false;
+  var coord = c.coordinate;
+  if (typeof coord.lat !== "number" || typeof coord.lng !== "number" || !Number.isFinite(coord.lat) || !Number.isFinite(coord.lng) || coord.lat < -90 || coord.lat > 90 || coord.lng < -180 || coord.lng > 180) {
+    return false;
+  }
+  if (typeof c.radiusMeters !== "number" || !Number.isFinite(c.radiusMeters) || c.radiusMeters <= 0) {
+    return false;
+  }
+  if (c.id !== undefined && typeof c.id !== "string") return false;
+  if (c.fillColor !== undefined && typeof c.fillColor !== "string") return false;
+  if (c.fillOpacity !== undefined) {
+    if (typeof c.fillOpacity !== "number" || !Number.isFinite(c.fillOpacity)) return false;
+  }
+  if (c.strokeColor !== undefined && typeof c.strokeColor !== "string") return false;
+  if (c.strokeWidth !== undefined) {
+    if (typeof c.strokeWidth !== "number" || !Number.isFinite(c.strokeWidth)) return false;
+  }
+  if (c.strokeOpacity !== undefined) {
+    if (typeof c.strokeOpacity !== "number" || !Number.isFinite(c.strokeOpacity)) return false;
+  }
+  if (c.floorId !== undefined && typeof c.floorId !== "string") return false;
+  if (c.renderOrder !== undefined && !CIRCLE_RENDER_ORDERS.includes(c.renderOrder)) {
+    return false;
+  }
+  return true;
+}
+
+/**
+ * Resolves a {@link CircleConfig} into a {@link CircleRecord}, applying
+ * default styling, generating an id when one is not provided, and validating inputs.
+ *
+ * @param config Circle configuration provided by the SDK consumer.
+ * @param hidden Initial hidden state, defaults to visible.
+ * @returns The resolved circle record ready to be stored and rendered.
+ * @throws {Error} If radiusMeters is ≤ 0, not finite, or coordinates are invalid.
+ *
+ * @group Circles
+ */
+function resolveCircleConfig(config) {
+  var _config$id, _config$fillColor, _config$strokeColor, _config$strokeWidth, _config$renderOrder;
+  var hidden = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+  validateRadiusMeters(config.radiusMeters);
+  validateCoordinate(config.coordinate);
+  if (config.renderOrder !== undefined && !CIRCLE_RENDER_ORDERS.includes(config.renderOrder)) {
+    throw new Error("Invalid renderOrder: ".concat(String(config.renderOrder), ". ") + "Must be one of: ".concat(CIRCLE_RENDER_ORDERS.join(", "), "."));
+  }
+  return {
+    id: (_config$id = config.id) !== null && _config$id !== void 0 ? _config$id : generateHexadecimalKey(),
+    // Copy the coordinate so later mutations of the caller's object
+    // can't change internal circle state
+    coordinate: {
+      lat: config.coordinate.lat,
+      lng: config.coordinate.lng
+    },
+    radiusMeters: config.radiusMeters,
+    fillColor: (_config$fillColor = config.fillColor) !== null && _config$fillColor !== void 0 ? _config$fillColor : CIRCLE_DEFAULTS.fillColor,
+    fillOpacity: clampOpacity(config.fillOpacity, CIRCLE_DEFAULTS.fillOpacity),
+    strokeColor: (_config$strokeColor = config.strokeColor) !== null && _config$strokeColor !== void 0 ? _config$strokeColor : CIRCLE_DEFAULTS.strokeColor,
+    strokeWidth: (_config$strokeWidth = config.strokeWidth) !== null && _config$strokeWidth !== void 0 ? _config$strokeWidth : CIRCLE_DEFAULTS.strokeWidth,
+    strokeOpacity: clampOpacity(config.strokeOpacity, CIRCLE_DEFAULTS.strokeOpacity),
+    floorId: config.floorId,
+    renderOrder: (_config$renderOrder = config.renderOrder) !== null && _config$renderOrder !== void 0 ? _config$renderOrder : CIRCLE_DEFAULTS.renderOrder,
+    hidden: hidden
+  };
+}
+
+/**
+ * Builds a closed GeoJSON polygon ring approximating a geographic circle.
+ *
+ * The ring is computed with an equirectangular approximation: meters are
+ * converted to degrees independently per axis, with the longitude scale
+ * corrected by the cosine of the latitude. For the radii the SDK works with
+ * (tens to hundreds of meters) the metric error is negligible (≤1%) at any latitude
+ * where the projection is defined. At extreme polar latitudes, the approximation
+ * breaks down, so circles near poles (|lat| > 85°) should be used with caution.
+ *
+ * @param lng Longitude of the circle center in degrees.
+ * @param lat Latitude of the circle center in degrees.
+ * @param radiusMeters Radius of the circle in meters. Must be positive and finite.
+ * @param points Number of segments in the ring. Defaults to 64. Non-integer
+ *               values are floored and the count is clamped to a minimum of 3,
+ *               the smallest valid GeoJSON linear ring; non-finite values fall
+ *               back to the default.
+ * @returns A closed ring of `[lng, lat]` positions (first equals last).
+ *
+ * @example
+ * ```typescript
+ * import { circleRing } from '@mapvx/web-js';
+ *
+ * // Create a 150-meter radius circle ring
+ * const ring = circleRing(-74.0060, 40.7128, 150);
+ * const polygon = { type: "Polygon", coordinates: [ring] };
+ *
+ * // Custom segments (32 instead of 64) for lower resolution
+ * const coarseRing = circleRing(-74.0060, 40.7128, 150, 32);
+ * ```
+ *
+ * @note Equirectangular approximation is accurate for radii up to ~500 km and
+ *       latitudes between approximately ±80°. Beyond these limits, visual
+ *       distortion may occur near the poles.
+ * @note Generated rings do not account for geographic obstacles, walls, or
+ *       buildings. For complex geofencing, consider server-side validation.
+ *
+ * @group Circles
+ */
+function circleRing(lng, lat, radiusMeters) {
+  var points = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 64;
+  // A linear ring needs at least 3 distinct positions to be valid GeoJSON
+  var segments = Number.isFinite(points) ? Math.max(3, Math.floor(points)) : 64;
+  var ring = [];
+  var latRad = lat * Math.PI / 180;
+  var metersPerDegLat = 110574;
+  var metersPerDegLng = 111320 * Math.cos(latRad || 0.000001);
+  var latR = radiusMeters / metersPerDegLat;
+  var lngR = radiusMeters / (metersPerDegLng || 1);
+  for (var i = 0; i < segments; i += 1) {
+    var a = i / segments * Math.PI * 2;
+    ring.push([lng + lngR * Math.cos(a), lat + latR * Math.sin(a)]);
+  }
+  // Close the ring with an exact copy of the first position, as GeoJSON requires
+  ring.push([ring[0][0], ring[0][1]]);
+  return ring;
+}
 ;// ./node_modules/.pnpm/@googlemaps+polyline-codec@1.0.28/node_modules/@googlemaps/polyline-codec/dist/index.esm.js
 /**
  * Copyright 2020 Google LLC
@@ -10821,11 +11354,9 @@ var Requester = /*#__PURE__*/function () {
     // Ensure we have an absolute URL (required for new URL() in fetchFromUrl)
     var withProtocol = apiUrl.startsWith("http://") || apiUrl.startsWith("https://") ? apiUrl : "https://".concat(apiUrl);
     var cleanApiUrl = withProtocol.endsWith("/") ? withProtocol.slice(0, -1) : withProtocol;
-    this.baseUrl = "".concat(cleanApiUrl, "/api/sdk/");
-    this.baseUrlV2 = "".concat(cleanApiUrl, "/api/sdk/v2/");
-    this.baseUrlApi = "".concat(cleanApiUrl, "/api/");
+    this.baseUrl = "".concat(cleanApiUrl, "/api/sdk/v2/");
     this.baseUrlPortal = "".concat(cleanApiUrl, "/api/portal/");
-    this.baseUrlHealth = "https://api.mapvx.com/api/health/";
+    this.baseUrlHealth = "https://api.mapvx.com/api/sdk/v2/health";
     this.oldBaseUrl = "https://api.mapvx.com/api/sdk/";
     this.routeBaseUrl = "https://api.mapvx.com/sdk/";
   }
@@ -10918,11 +11449,11 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 stopId: stopId,
                 lang: this.lang
               };
@@ -10954,11 +11485,11 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 stopId: stopId,
                 vehicleId: vehicleId,
                 lang: this.lang
@@ -10990,11 +11521,11 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 lang: this.lang
               };
               if (placeId != null) {
@@ -11067,11 +11598,11 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 lang: this.lang
               };
               return _context6.a(2, this.fetchFromUrl(this.baseUrl + "availablePlaces", params, options));
@@ -11140,11 +11671,11 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 place_id: placeId,
                 lang: this.lang
               };
@@ -11214,11 +11745,11 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 targetPlace: targetPlaceId,
                 lang: this.lang
               };
@@ -11272,72 +11803,118 @@ var Requester = /*#__PURE__*/function () {
       }
       return fetchAnySubPlaces;
     }()
+    /**
+     * Build the cleaned query parameters for a route request.
+     *
+     * Resolves both the origin (`from*`) and destination (`to*`) sides of the route
+     * from the provided configuration. For {@link IdLocation} endpoints this also
+     * forwards the building (`fromBuilding`/`toBuilding`) and floor
+     * (`fromFloor`/`toFloor`) so internal aliases that are reused across buildings
+     * can be disambiguated. Parameters that resolve to `null`/`undefined` are dropped.
+     * @param routeConfig The route configuration to translate into query params.
+     * @returns The cleaned query parameters ready to be appended to the request URL.
+     */
+    )
+  }, {
+    key: "buildRouteParams",
+    value: function buildRouteParams(routeConfig) {
+      var params = {
+        fromLatLng: undefined,
+        fromBuilding: undefined,
+        fromFloor: undefined,
+        toLatLng: undefined,
+        toBuilding: undefined,
+        toFloor: undefined,
+        fromPlaceId: undefined,
+        toPlaceId: undefined,
+        travelMode: TransportationMode.walking,
+        reducedMobility: routeConfig.preferAccessibleRoute ? 1 : 0,
+        announceFormat: routeConfig.announceFormat,
+        userBearing: routeConfig.userBearing,
+        lang: this.lang,
+        unitSystem: routeConfig.unitSystem
+      };
+      if ("id" in routeConfig.initialLocation) {
+        var _routeConfig$initialL = routeConfig.initialLocation,
+          id = _routeConfig$initialL.id,
+          buildingId = _routeConfig$initialL.buildingId,
+          floorId = _routeConfig$initialL.floorId,
+          level = _routeConfig$initialL.level;
+        params.fromPlaceId = id;
+        if (buildingId !== undefined) {
+          params.fromBuilding = buildingId;
+        }
+        if (floorId !== undefined) {
+          params.fromFloor = floorId;
+        } else if (level !== undefined) {
+          params.fromFloor = level;
+        }
+      } else {
+        var _routeConfig$initialL2 = routeConfig.initialLocation,
+          lat = _routeConfig$initialL2.lat,
+          lng = _routeConfig$initialL2.lng,
+          _floorId = _routeConfig$initialL2.floorId,
+          placeId = _routeConfig$initialL2.placeId;
+        params.fromLatLng = "".concat(lat, ",").concat(lng);
+        params.fromFloor = _floorId;
+        params.fromBuilding = placeId;
+      }
+      if ("id" in routeConfig.finalLocation) {
+        var _routeConfig$finalLoc = routeConfig.finalLocation,
+          _id = _routeConfig$finalLoc.id,
+          _buildingId = _routeConfig$finalLoc.buildingId,
+          _floorId2 = _routeConfig$finalLoc.floorId,
+          _level = _routeConfig$finalLoc.level;
+        params.toPlaceId = _id;
+        if (_buildingId !== undefined) {
+          params.toBuilding = _buildingId;
+        }
+        if (_floorId2 !== undefined) {
+          params.toFloor = _floorId2;
+        } else if (_level !== undefined) {
+          params.toFloor = _level;
+        }
+      } else {
+        var _routeConfig$finalLoc2 = routeConfig.finalLocation,
+          _lat = _routeConfig$finalLoc2.lat,
+          _lng = _routeConfig$finalLoc2.lng,
+          _floorId3 = _routeConfig$finalLoc2.floorId,
+          _placeId = _routeConfig$finalLoc2.placeId;
+        params.toLatLng = "".concat(_lat, ",").concat(_lng);
+        params.toFloor = _floorId3;
+        params.toBuilding = _placeId;
+      }
+      var cleanParams = {};
+      for (var key in params) {
+        var value = params[key];
+        if (value != null) {
+          cleanParams[key] = value;
+        }
+      }
+      return cleanParams;
+    }
+
     /**
      * To obtain the route
      * @param routeConfig
      * @returns
      */
-    )
   }, {
     key: "fetchRoute",
     value: (function () {
       var _fetchRoute = requester_asyncToGenerator(/*#__PURE__*/requester_regenerator().m(function _callee10(routeConfig, token) {
-        var options, params, _routeConfig$initialL, lat, lng, floorId, placeId, _routeConfig$finalLoc, _lat, _lng, _floorId, _placeId, cleanParams, key, value;
+        var options, cleanParams;
         return requester_regenerator().w(function (_context10) {
           while (1) switch (_context10.n) {
             case 0:
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
-              params = {
-                fromLatLng: undefined,
-                fromBuilding: undefined,
-                fromFloor: undefined,
-                toLatLng: undefined,
-                toBuilding: undefined,
-                toFloor: undefined,
-                fromPlaceId: undefined,
-                toPlaceId: undefined,
-                travelMode: TransportationMode.walking,
-                reducedMobility: routeConfig.preferAccessibleRoute ? 1 : 0,
-                announceFormat: routeConfig.announceFormat,
-                userBearing: 0,
-                lang: this.lang,
-                unitSystem: routeConfig.unitSystem,
-                token: token
-              };
-              if ("id" in routeConfig.initialLocation) {
-                params.fromPlaceId = routeConfig.initialLocation.id;
-                if (routeConfig.initialLocation.level !== undefined) {
-                  params.fromFloor = routeConfig.initialLocation.level;
-                }
-              } else {
-                _routeConfig$initialL = routeConfig.initialLocation, lat = _routeConfig$initialL.lat, lng = _routeConfig$initialL.lng, floorId = _routeConfig$initialL.floorId, placeId = _routeConfig$initialL.placeId;
-                params.fromLatLng = "".concat(lat, ",").concat(lng);
-                params.fromFloor = floorId;
-                params.fromBuilding = placeId;
-              }
-              if ("id" in routeConfig.finalLocation) {
-                params.toPlaceId = routeConfig.finalLocation.id;
-                if (routeConfig.finalLocation.level !== undefined) {
-                  params.toFloor = routeConfig.finalLocation.level;
-                }
-              } else {
-                _routeConfig$finalLoc = routeConfig.finalLocation, _lat = _routeConfig$finalLoc.lat, _lng = _routeConfig$finalLoc.lng, _floorId = _routeConfig$finalLoc.floorId, _placeId = _routeConfig$finalLoc.placeId;
-                params.toLatLng = "".concat(_lat, ",").concat(_lng);
-                params.toFloor = _floorId;
-                params.toBuilding = _placeId;
-              }
-              cleanParams = {};
-              for (key in params) {
-                value = params[key];
-                if (value != null) {
-                  cleanParams[key] = value;
-                }
-              }
+              cleanParams = this.buildRouteParams(routeConfig);
               return _context10.a(2, this.fetchFromUrl(this.routeBaseUrl + "route", cleanParams, options));
           }
         }, _callee10, this);
@@ -11357,62 +11934,18 @@ var Requester = /*#__PURE__*/function () {
     key: "fetchRouteV2",
     value: (function () {
       var _fetchRouteV = requester_asyncToGenerator(/*#__PURE__*/requester_regenerator().m(function _callee11(routeConfig, token) {
-        var options, params, _routeConfig$initialL2, lat, lng, floorId, placeId, _routeConfig$finalLoc2, _lat2, _lng2, _floorId2, _placeId2, cleanParams, key, value;
+        var options, cleanParams;
         return requester_regenerator().w(function (_context11) {
           while (1) switch (_context11.n) {
             case 0:
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
-              params = {
-                fromLatLng: undefined,
-                fromBuilding: undefined,
-                fromFloor: undefined,
-                toLatLng: undefined,
-                toBuilding: undefined,
-                toFloor: undefined,
-                fromPlaceId: undefined,
-                toPlaceId: undefined,
-                travelMode: TransportationMode.walking,
-                reducedMobility: routeConfig.preferAccessibleRoute ? 1 : 0,
-                announceFormat: routeConfig.announceFormat,
-                userBearing: 0,
-                lang: this.lang,
-                unitSystem: routeConfig.unitSystem,
-                token: token
-              };
-              if ("id" in routeConfig.initialLocation) {
-                params.fromPlaceId = routeConfig.initialLocation.id;
-                if (routeConfig.initialLocation.level !== undefined) {
-                  params.fromFloor = routeConfig.initialLocation.level;
-                }
-              } else {
-                _routeConfig$initialL2 = routeConfig.initialLocation, lat = _routeConfig$initialL2.lat, lng = _routeConfig$initialL2.lng, floorId = _routeConfig$initialL2.floorId, placeId = _routeConfig$initialL2.placeId;
-                params.fromLatLng = "".concat(lat, ",").concat(lng);
-                params.fromFloor = floorId;
-                params.fromBuilding = placeId;
-              }
-              if ("id" in routeConfig.finalLocation) {
-                params.toPlaceId = routeConfig.finalLocation.id;
-                if (routeConfig.finalLocation.level !== undefined) {
-                  params.toFloor = routeConfig.finalLocation.level;
-                }
-              } else {
-                _routeConfig$finalLoc2 = routeConfig.finalLocation, _lat2 = _routeConfig$finalLoc2.lat, _lng2 = _routeConfig$finalLoc2.lng, _floorId2 = _routeConfig$finalLoc2.floorId, _placeId2 = _routeConfig$finalLoc2.placeId;
-                params.toLatLng = "".concat(_lat2, ",").concat(_lng2);
-                params.toFloor = _floorId2;
-                params.toBuilding = _placeId2;
-              }
-              cleanParams = {};
-              for (key in params) {
-                value = params[key];
-                if (value != null) {
-                  cleanParams[key] = value;
-                }
-              }
+              cleanParams = this.buildRouteParams(routeConfig);
               return _context11.a(2, this.fetchFromUrl(this.routeBaseUrl + "v2/route", cleanParams, options));
           }
         }, _callee11, this);
@@ -11441,11 +11974,11 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 lang: this.lang
               };
               return _context12.a(2, this.fetchFromUrl(this.baseUrl + "institution", params, options));
@@ -11481,14 +12014,14 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
                 institution_id: institutionId,
                 input: input,
-                lang: this.lang,
-                token: token
+                lang: this.lang
               };
               if (parentIds) {
                 params.parentPlaces = requester_toConsumableArray(parentIds);
@@ -11541,7 +12074,7 @@ var Requester = /*#__PURE__*/function () {
         return requester_regenerator().w(function (_context14) {
           while (1) switch (_context14.n) {
             case 0:
-              // The v2 endpoint authenticates via the Authorization header (Bearer),
+              // The v2 endpoints authenticate via the Authorization header (Bearer),
               // not via a `token` query parameter like the legacy /api/sdk/* routes.
               options = {
                 method: "GET",
@@ -11573,7 +12106,7 @@ var Requester = /*#__PURE__*/function () {
               if (floor) {
                 params.floor = floor;
               }
-              return _context14.a(2, this.fetchFromUrl(this.baseUrlV2 + "searchPlacesByTags", params, options));
+              return _context14.a(2, this.fetchFromUrl(this.baseUrl + "searchPlacesByTags", params, options));
           }
         }, _callee14, this);
       }));
@@ -11593,16 +12126,16 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 lang: this.lang
               };
               if (place_id) params.place_id = place_id;
               if (product) params.product = product;
-              return _context15.a(2, this.fetchFromUrl(this.baseUrlApi + "configuration", params, options));
+              return _context15.a(2, this.fetchFromUrl(this.baseUrl + "configuration", params, options));
           }
         }, _callee15, this);
       }));
@@ -11622,15 +12155,15 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 lang: this.lang
               };
               if (place_id) params.id = place_id;
-              return _context16.a(2, this.fetchFromUrl(this.baseUrlApi + "category", params, options));
+              return _context16.a(2, this.fetchFromUrl(this.baseUrl + "category", params, options));
           }
         }, _callee16, this);
       }));
@@ -11650,11 +12183,11 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 placeId: parentPlaceId,
                 fromPlace: fromPlaceId,
                 announceFormat: announceFormat,
@@ -11682,11 +12215,11 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 placeId: placeId
               };
               return _context18.a(2, this.fetchFromUrl(this.routeBaseUrl + "cache_timestamp", params, options));
@@ -11709,14 +12242,14 @@ var Requester = /*#__PURE__*/function () {
               options = {
                 method: "GET",
                 headers: {
-                  "content-type": "application/json"
+                  "content-type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 }
               };
               params = {
-                token: token,
                 type: type
               };
-              return _context19.a(2, this.fetchFromUrl(this.baseUrlApi + "styles/customStyles", params, options));
+              return _context19.a(2, this.fetchFromUrl(this.baseUrl + "styles/customStyles", params, options));
           }
         }, _callee19, this);
       }));
@@ -11739,14 +12272,13 @@ var Requester = /*#__PURE__*/function () {
                 totemId: totemId,
                 status: status
               });
-              params = {
-                token: token
-              };
+              params = {};
               options = {
                 method: "POST",
                 headers: {
                   accept: "application/json",
-                  "Content-Type": "application/json"
+                  "Content-Type": "application/json",
+                  Authorization: "Bearer ".concat(token)
                 },
                 body: requestData
               };
@@ -11826,7 +12358,6 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
     _this.token = token;
     _this.currentLang = lang;
     _this.requester = new Requester(lang, apiUrl, mapvxRequestContext);
-    _this.lang = lang;
     _this.cache = cache !== null && cache !== void 0 ? cache : new CacheManager();
     return _this;
   }
@@ -12033,7 +12564,7 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
           while (1) switch (_context4.p = _context4.n) {
             case 0:
               _context4.p = 0;
-              cachedPlace = this.cache.getPlace(placeId, this.lang);
+              cachedPlace = this.cache.getPlace(placeId, this.currentLang);
               if (!(cachedPlace != null)) {
                 _context4.n = 1;
                 break;
@@ -12062,9 +12593,9 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
             case 5:
               responseData = _context4.v;
               place = new place_MVXPlace(responseData);
-              this.cache.setPlace(place.mapvxId, place, this.lang);
+              this.cache.setPlace(place.mapvxId, place, this.currentLang);
               if (place.clientId != null) {
-                this.cache.setPlace(place.clientId, place, this.lang);
+                this.cache.setPlace(place.clientId, place, this.currentLang);
               }
               this.logEvent("fetchAndParsePlaceDetail", {
                 cached: "false"
@@ -12093,7 +12624,7 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
           while (1) switch (_context5.p = _context5.n) {
             case 0:
               _context5.p = 0;
-              cachedPlace = this.cache.getPlace(placeId, this.lang);
+              cachedPlace = this.cache.getPlace(placeId, this.currentLang);
               if (!(cachedPlace != null)) {
                 _context5.n = 1;
                 break;
@@ -12122,9 +12653,9 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
             case 5:
               responseData = _context5.v;
               place = new place_MVXPlace(responseData);
-              this.cache.setPlace(place.mapvxId, place, this.lang);
+              this.cache.setPlace(place.mapvxId, place, this.currentLang);
               if (place.clientId != null) {
-                this.cache.setPlace(place.clientId, place, this.lang);
+                this.cache.setPlace(place.clientId, place, this.currentLang);
               }
               this.logEvent("fetchAndParseAnyPlaceDetail", {
                 cached: "false"
@@ -12249,11 +12780,11 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
               });
               this.logEvent("fetchAndParseAnySubPlaces");
               subPlaces.forEach(function (place) {
-                if (!_this3.cache.hasPlace(place.mapvxId, _this3.lang)) {
-                  _this3.cache.setPlace(place.mapvxId, place, _this3.lang);
+                if (!_this3.cache.hasPlace(place.mapvxId, _this3.currentLang)) {
+                  _this3.cache.setPlace(place.mapvxId, place, _this3.currentLang);
                 }
-                if (place.clientId != null && !_this3.cache.hasPlace(place.clientId, _this3.lang)) {
-                  _this3.cache.setPlace(place.clientId, place, _this3.lang);
+                if (place.clientId != null && !_this3.cache.hasPlace(place.clientId, _this3.currentLang)) {
+                  _this3.cache.setPlace(place.clientId, place, _this3.currentLang);
                 }
               });
               return _context7.a(2, subPlaces);
@@ -12304,11 +12835,11 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
               });
               this.logEvent("fetchAndParseAvailablePlaces");
               data.forEach(function (place) {
-                if (!_this4.cache.hasPlace(place.mapvxId, _this4.lang)) {
-                  _this4.cache.setPlace(place.mapvxId, place, _this4.lang);
+                if (!_this4.cache.hasPlace(place.mapvxId, _this4.currentLang)) {
+                  _this4.cache.setPlace(place.mapvxId, place, _this4.currentLang);
                 }
-                if (place.clientId != null && !_this4.cache.hasPlace(place.clientId, _this4.lang)) {
-                  _this4.cache.setPlace(place.clientId, place, _this4.lang);
+                if (place.clientId != null && !_this4.cache.hasPlace(place.clientId, _this4.currentLang)) {
+                  _this4.cache.setPlace(place.clientId, place, _this4.currentLang);
                 }
               });
               return _context8.a(2, data);
@@ -12362,11 +12893,11 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
               });
               this.logEvent("fetchAndParsePlacesFromInstitution");
               data.forEach(function (place) {
-                if (!_this5.cache.hasPlace(place.mapvxId, _this5.lang)) {
-                  _this5.cache.setPlace(place.mapvxId, place, _this5.lang);
+                if (!_this5.cache.hasPlace(place.mapvxId, _this5.currentLang)) {
+                  _this5.cache.setPlace(place.mapvxId, place, _this5.currentLang);
                 }
-                if (place.clientId != null && !_this5.cache.hasPlace(place.clientId, _this5.lang)) {
-                  _this5.cache.setPlace(place.clientId, place, _this5.lang);
+                if (place.clientId != null && !_this5.cache.hasPlace(place.clientId, _this5.currentLang)) {
+                  _this5.cache.setPlace(place.clientId, place, _this5.currentLang);
                 }
               });
               return _context9.a(2, data);
@@ -12393,7 +12924,7 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
       var _this6 = this;
       var places = [];
       ids.forEach(function (id) {
-        var place = _this6.cache.getPlace(id, _this6.lang);
+        var place = _this6.cache.getPlace(id, _this6.currentLang);
         if (place != null) {
           places.push(place);
         }
@@ -12542,8 +13073,8 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
           while (1) switch (_context10.p = _context10.n) {
             case 0:
               _context10.p = 0;
-              cachedResponse = this.cache.getVehicle(stopId, this.lang);
-              if (!(cachedResponse != null && (Date.now() - cachedResponse.timestamp < 60 * 100 || cachedResponse.data.routes.length === 0))) {
+              cachedResponse = this.cache.getVehicle(stopId, this.currentLang);
+              if (!(cachedResponse != null && (Date.now() - cachedResponse.timestamp < 60 * 1000 || cachedResponse.data.routes.length === 0))) {
                 _context10.n = 1;
                 break;
               }
@@ -12594,7 +13125,7 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
               this.cache.setVehicle(stopId, {
                 timestamp: Date.now(),
                 data: transport
-              }, this.lang);
+              }, this.currentLang);
               this.logEvent("fetchAndParseTransport", {
                 cached: "false"
               });
@@ -12602,7 +13133,7 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
             case 8:
               _context10.p = 8;
               _t10 = _context10.v;
-              _cachedResponse = this.cache.getVehicle(stopId, this.lang);
+              _cachedResponse = this.cache.getVehicle(stopId, this.currentLang);
               if (!(_cachedResponse != null)) {
                 _context10.n = 9;
                 break;
@@ -12636,7 +13167,7 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
           while (1) switch (_context11.p = _context11.n) {
             case 0:
               _context11.p = 0;
-              cachedResponse = this.cache.getStops(stopId + vehicleId, this.lang);
+              cachedResponse = this.cache.getStops(stopId + vehicleId, this.currentLang);
               if (!(cachedResponse != null && Date.now() - cachedResponse.timestamp < 60 * 1000)) {
                 _context11.n = 1;
                 break;
@@ -12673,7 +13204,7 @@ var Repository = /*#__PURE__*/function (_Loggeable) {
               this.cache.setStops(stopId + vehicleId, {
                 timestamp: Date.now(),
                 data: data
-              }, this.lang);
+              }, this.currentLang);
               this.logEvent("fetchAndParseStops", {
                 cached: "false"
               });
@@ -13180,17 +13711,69 @@ function extractStepCoordinates(step) {
   }
   return coords;
 }
+;// ./src/map/mapInteractionOptions.ts
+/**
+ * Subset of MapLibre {@link MapOptions} that can be derived from the interaction
+ * restriction flags on {@link MapConfig}.
+ *
+ * @internal
+ */
+
+/**
+ * Translates the interaction/rotation flags from {@link MapConfig} into the
+ * matching MapLibre constructor options.
+ *
+ * Only keys that were explicitly provided are returned, so MapLibre's defaults
+ * (every interaction enabled) are preserved for any flag left `undefined`. This
+ * deliberately avoids writing `undefined` into the options object, which would
+ * otherwise override MapLibre defaults with `NaN`/`undefined`.
+ *
+ * `rotateEnabled: false` disables drag- and pitch-rotation up front. Touch
+ * rotation cannot be turned off via the constructor without also killing
+ * pinch-to-zoom, so it is handled separately after construction — see
+ * {@link shouldDisableTouchRotation}.
+ *
+ * @internal
+ */
+function buildInteractionOptions(mapConfig) {
+  var options = {};
+  if (mapConfig.bearing !== undefined) options.bearing = mapConfig.bearing;
+  if (mapConfig.interactive !== undefined) options.interactive = mapConfig.interactive;
+  if (mapConfig.dragPan !== undefined) options.dragPan = mapConfig.dragPan;
+  if (mapConfig.scrollZoom !== undefined) options.scrollZoom = mapConfig.scrollZoom;
+  if (mapConfig.doubleClickZoom !== undefined) options.doubleClickZoom = mapConfig.doubleClickZoom;
+  if (mapConfig.touchZoomRotate !== undefined) options.touchZoomRotate = mapConfig.touchZoomRotate;
+  if (mapConfig.keyboard !== undefined) options.keyboard = mapConfig.keyboard;
+  if (mapConfig.rotateEnabled === false) {
+    options.dragRotate = false;
+    options.pitchWithRotate = false;
+  }
+  return options;
+}
+
+/**
+ * Whether two-finger touch rotation must be disabled after the map is created.
+ *
+ * `rotateEnabled: false` should keep pinch-to-zoom working, so the touch
+ * rotation is disabled via `map.touchZoomRotate.disableRotation()` once the map
+ * instance exists rather than through the constructor.
+ *
+ * @internal
+ */
+function shouldDisableTouchRotation(mapConfig) {
+  return mapConfig.rotateEnabled === false;
+}
 ;// ./src/map/map.ts
 function map_typeof(o) { "@babel/helpers - typeof"; return map_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, map_typeof(o); }
 function map_regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return map_regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (map_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, map_regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, map_regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), map_regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", map_regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), map_regeneratorDefine2(u), map_regeneratorDefine2(u, o, "Generator"), map_regeneratorDefine2(u, n, function () { return this; }), map_regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (map_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
 function map_regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } map_regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { map_regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, map_regeneratorDefine2(e, r, n, t); }
 function map_asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
 function map_asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { map_asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { map_asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
-function map_createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = map_unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
 function map_slicedToArray(r, e) { return map_arrayWithHoles(r) || map_iterableToArrayLimit(r, e) || map_unsupportedIterableToArray(r, e) || map_nonIterableRest(); }
 function map_nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function map_iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function map_arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+function map_createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = map_unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
 function map_toConsumableArray(r) { return map_arrayWithoutHoles(r) || map_iterableToArray(r) || map_unsupportedIterableToArray(r) || map_nonIterableSpread(); }
 function map_nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function map_unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return map_arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? map_arrayLikeToArray(r, a) : void 0; } }
@@ -13214,6 +13797,38 @@ function map_toPropertyKey(t) { var i = map_toPrimitive(t, "string"); return "sy
 function map_toPrimitive(t, r) { if ("object" != map_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != map_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 
 
+
+/** Shared GeoJSON source holding every circle drawn through the circle API. */
+var CIRCLE_SOURCE_ID = "mapvx-circles";
+/** Fill layer rendering the translucent interior of the circles. */
+var CIRCLE_FILL_LAYER_ID = "mapvx-circles-fill";
+/** Line layer rendering the circle outlines. */
+var CIRCLE_LINE_LAYER_ID = "mapvx-circles-line";
+
+/**
+ * Layer-id suffix per circle render order. The default placement keeps the
+ * unsuffixed ids so existing consumers referencing them keep working.
+ */
+var CIRCLE_LAYER_SUFFIXES = {
+  aboveBasemap: "",
+  belowLabels: "-below-labels",
+  top: "-top"
+};
+
+/** Fill/line layer ids for one circle render-order bucket. */
+function circleLayerIdsFor(order) {
+  var suffix = CIRCLE_LAYER_SUFFIXES[order];
+  return {
+    fill: CIRCLE_FILL_LAYER_ID + suffix,
+    line: CIRCLE_LINE_LAYER_ID + suffix
+  };
+}
+
+/** True for the layer ids owned by the circle API, regardless of bucket. */
+function isCircleLayerId(id) {
+  return id.startsWith(CIRCLE_FILL_LAYER_ID) || id.startsWith(CIRCLE_LINE_LAYER_ID);
+}
+
 // Flag to track if cached-tile protocol has been registered
 var cachedTileProtocolRegistered = false;
 
@@ -13236,23 +13851,40 @@ function deepClone(obj) {
 /**
  * Register a custom protocol for cached tiles that routes requests through the main thread.
  * This allows the service worker to intercept and cache tile requests.
+ *
+ * Wraps fetches in a {@link Semaphore} so tile CDN / WAFs are not hit with
+ * unbounded parallel requests (same host as the service worker cache). The
+ * semaphore is created once with the limit from the first map's config; later
+ * calls are no-ops because the protocol can only be registered once globally
+ * on MapLibre.
+ *
+ * @param maxConcurrentFetches - Maximum number of in-flight tile fetches.
  */
-function registerCachedTileProtocol() {
+function registerCachedTileProtocol(maxConcurrentFetches) {
   if (cachedTileProtocolRegistered) return;
+  var semaphore = new Semaphore(maxConcurrentFetches);
   maplibre_gl_default().addProtocol("cached-tile", function (params, abortController) {
-    // Convert cached-tile:// URL back to https://
     var url = params.url.replace("cached-tile://", "https://");
-    return fetch(url, {
-      signal: abortController.signal
-    }).then(function (response) {
-      if (!response.ok) {
-        throw new Error("HTTP error! status: ".concat(response.status));
-      }
-      return response.arrayBuffer();
-    }).then(function (data) {
-      return {
-        data: data
-      };
+
+    // Pass the abort signal to acquire() so a request cancelled while still
+    // queued (e.g. during rapid zoom) drops out of the FIFO queue instead of
+    // waiting for a slot just to bail. release() runs only inside this chain,
+    // i.e. only after a slot was actually granted.
+    return semaphore.acquire(abortController.signal).then(function () {
+      return fetch(url, {
+        signal: abortController.signal
+      }).then(function (response) {
+        if (!response.ok) {
+          throw new Error("HTTP error! status: ".concat(response.status));
+        }
+        return response.arrayBuffer();
+      }).then(function (data) {
+        return {
+          data: data
+        };
+      })["finally"](function () {
+        semaphore.release();
+      });
     });
   });
   cachedTileProtocolRegistered = true;
@@ -13327,6 +13959,8 @@ function convertPaddingToPixels(padding, containerWidth, containerHeight) {
 
 
 
+
+
 /**
  * @group Map
  */
@@ -13356,6 +13990,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
     map_defineProperty(_this, "currentFloor", "");
     map_defineProperty(_this, "baseFilters", {});
     map_defineProperty(_this, "markers", []);
+    map_defineProperty(_this, "circles", []);
     map_defineProperty(_this, "enableHover", false);
     map_defineProperty(_this, "hoveredId", "unselected");
     map_defineProperty(_this, "failedTiles", new Set());
@@ -13371,8 +14006,11 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
     _this.watchPositionID = undefined;
     _this.onFloorChange = mapConfig.onFloorChange;
     _this.onParentPlaceChange = mapConfig.onParentPlaceChange;
-    // Merge tile cache config with defaults
-    _this.tileCacheConfig = map_objectSpread(map_objectSpread({}, DEFAULT_TILE_CACHE_CONFIG), mapConfig.tileCache);
+    _this.tileCacheConfig = function () {
+      var merged = map_objectSpread(map_objectSpread({}, DEFAULT_TILE_CACHE_CONFIG), mapConfig.tileCache);
+      merged.maxTiles = Math.min(merged.maxTiles, MAPLIBRE_MAX_TILE_CACHE_HARD_CAP);
+      return merged;
+    }();
     if (mapConfig.parentPlaceId != null) {
       _this.initialPlaceDetailSetUp(mapConfig.parentPlaceId, mapConfig.authToken);
     }
@@ -13482,15 +14120,13 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         _this6 = this;
       // Determine if service worker caching should be enabled
       var useServiceWorkerCaching = this.tileCacheConfig.enabled && this.tileCacheConfig.persistToServiceWorker;
-
-      // Register cached-tile protocol only if service worker caching is enabled
       if (useServiceWorkerCaching) {
-        registerCachedTileProtocol();
+        registerCachedTileProtocol(this.tileCacheConfig.maxConcurrentTileFetches);
       }
 
       // Transform tile URLs only if service worker caching is enabled
       var finalStyle = useServiceWorkerCaching ? this.transformStyleForCaching(style) : style;
-      var mapOptions = {
+      var mapOptions = map_objectSpread({
         container: container,
         style: finalStyle,
         center: mapConfig.center,
@@ -13499,10 +14135,10 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         attributionControl: false,
         maplibreLogo: false,
         bearingSnap: (_mapConfig$bearingSna = mapConfig.bearingSnap) !== null && _mapConfig$bearingSna !== void 0 ? _mapConfig$bearingSna : 0,
-        cancelPendingTileRequestsWhileZooming: false,
+        cancelPendingTileRequestsWhileZooming: true,
         // Use configured maxTiles for MapLibre's memory cache
         maxTileCacheSize: this.tileCacheConfig.maxTiles
-      };
+      }, buildInteractionOptions(mapConfig));
       if (mapConfig.maxZoom) mapOptions.maxZoom = mapConfig.maxZoom;
       if (mapConfig.minZoom) mapOptions.minZoom = mapConfig.minZoom;
       if (mapConfig.maxBounds && mapConfig.maxBounds.length > 1) {
@@ -13510,6 +14146,12 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         mapOptions.maxBounds = new maplibre_gl.LngLatBounds([boundingBox[0].lng, boundingBox[0].lat], [boundingBox[1].lng, boundingBox[1].lat]);
       }
       this.map = new maplibre_gl.Map(mapOptions);
+      // When rotation is disabled we still want pinch-to-zoom to work, so the
+      // two-finger rotation is turned off here instead of via the constructor.
+      if (shouldDisableTouchRotation(mapConfig)) {
+        var _this$map$touchZoomRo, _this$map$touchZoomRo2;
+        (_this$map$touchZoomRo = this.map.touchZoomRotate) === null || _this$map$touchZoomRo === void 0 || (_this$map$touchZoomRo2 = _this$map$touchZoomRo.disableRotation) === null || _this$map$touchZoomRo2 === void 0 || _this$map$touchZoomRo2.call(_this$map$touchZoomRo);
+      }
       this.map.addControl(new maplibre_gl.NavigationControl({
         showCompass: mapConfig.showCompass !== undefined ? mapConfig.showCompass : true,
         showZoom: mapConfig.showZoom !== undefined ? mapConfig.showZoom : true
@@ -13522,6 +14164,11 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         _this6.onHover();
         _this6.subscribeToFailedTiles();
       });
+      // Self-healing for circles: a full style reload wipes custom sources and
+      // layers, and not every restyle path goes through whenStyleUpdates.
+      this.map.on("styledata", function () {
+        if (_this6.circles.length > 0) _this6.ensureCircleLayers();
+      });
       this.map.on("zoomend", function () {
         var _mapConfig$onZoomEnd;
         (_mapConfig$onZoomEnd = mapConfig.onZoomEnd) === null || _mapConfig$onZoomEnd === void 0 || _mapConfig$onZoomEnd.call(mapConfig, _this6.getZoomLevel());
@@ -13619,6 +14266,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "destroyMap",
     value: function destroyMap() {
+      this.circles = [];
       this.map.remove();
       this.unsubscribeFromFailedTiles();
     }
@@ -13727,7 +14375,22 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "setLang",
     value: function setLang(lang) {
+      var _this0 = this;
       this.repository.setLang(lang);
+      if (rtlLanguages.includes(lang)) {
+        this.setRTLSupport();
+      }
+      // setLayersForLanguage reads this.map.getStyle()?.layers, which is empty
+      // until the style finishes loading. If setLang is called right after
+      // createMap (before the "load" event), apply it once the style is ready
+      // so the language change is not silently dropped.
+      if (this.map.isStyleLoaded()) {
+        this.setLayersForLanguage(lang);
+      } else {
+        this.map.once("load", function () {
+          return _this0.setLayersForLanguage(lang);
+        });
+      }
     }
   }, {
     key: "setParentPlace",
@@ -13756,12 +14419,13 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         this.setBaseFilters(newStyle);
       }
       this.routeController.addSourcesAndLayers();
+      this.refreshCircles();
       this.filterByFloorKey(this.currentFloor);
     }
   }, {
     key: "addMarker",
     value: function addMarker(marker) {
-      var _this0 = this;
+      var _this1 = this;
       try {
         var _this$innerFloors$fin4, _this$innerFloors$fin5;
         // Check if a marker with the same ID already exists and remove it
@@ -13781,7 +14445,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         }
         var markerCreated = new MarkerAttribute(marker);
         var isOutdoor = !this.parentPlace || ((_this$innerFloors$fin4 = (_this$innerFloors$fin5 = this.innerFloors.find(function (floor) {
-          return floor.key === _this0.currentFloor;
+          return floor.key === _this1.currentFloor;
         })) === null || _this$innerFloors$fin5 === void 0 ? void 0 : _this$innerFloors$fin5.reachableFromGPS) !== null && _this$innerFloors$fin4 !== void 0 ? _this$innerFloors$fin4 : false);
         markerCreated.changeFloor(this.currentFloor, this.map, isOutdoor);
         this.markers.push(markerCreated);
@@ -13884,6 +14548,374 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         throw new Error("Failed to remove all markers");
       }
     }
+  }, {
+    key: "addCircle",
+    value: function addCircle(circle) {
+      try {
+        // Check if a circle with the same ID already exists and replace it
+        if (circle.id) {
+          this.circles = this.circles.filter(function (c) {
+            return c.id !== circle.id;
+          });
+        }
+        // resolveCircleConfig validates radiusMeters and coordinates
+        var record = resolveCircleConfig(circle);
+        this.circles.push(record);
+        this.refreshCircles();
+        this.logEvent("addCircle");
+        return record.id;
+      } catch (error) {
+        throw new Error("Failed to add circle: ".concat(error instanceof Error ? error.message : String(error)));
+      }
+    }
+  }, {
+    key: "updateCircle",
+    value: function updateCircle(circleConfig) {
+      try {
+        var index = this.circles.findIndex(function (c) {
+          return c.id === circleConfig.id;
+        });
+        if (index === -1) return null;
+
+        // resolveCircleConfig validates radiusMeters and coordinates
+        this.circles[index] = resolveCircleConfig(circleConfig, this.circles[index].hidden);
+        this.refreshCircles();
+        this.logEvent("updateCircle");
+        return this.circles[index].id;
+      } catch (error) {
+        throw new Error("Failed to update circle: ".concat(error instanceof Error ? error.message : String(error)));
+      }
+    }
+  }, {
+    key: "getCircle",
+    value: function getCircle(circleId) {
+      var circle = this.circles.find(function (c) {
+        return c.id === circleId;
+      });
+      return circle ? cloneCircleRecord(circle) : undefined;
+    }
+  }, {
+    key: "getCircles",
+    value: function getCircles() {
+      return this.circles.map(cloneCircleRecord);
+    }
+  }, {
+    key: "hasCircle",
+    value: function hasCircle(circleId) {
+      return this.circles.some(function (c) {
+        return c.id === circleId;
+      });
+    }
+  }, {
+    key: "updateCirclePosition",
+    value: function updateCirclePosition(circleId, center, radiusMeters) {
+      try {
+        var _circle = this.circles.find(function (c) {
+          return c.id === circleId;
+        });
+        if (_circle === undefined) return false;
+
+        // Validate inputs before modifying
+        if (!center) {
+          throw new Error("Circle center is required");
+        }
+        var lat = center.lat,
+          lng = center.lng;
+        if (!Number.isFinite(lat) || lat < -90 || lat > 90) {
+          throw new Error("Invalid latitude: ".concat(lat, ". Must be between -90 and 90."));
+        }
+        if (!Number.isFinite(lng) || lng < -180 || lng > 180) {
+          throw new Error("Invalid longitude: ".concat(lng, ". Must be between -180 and 180."));
+        }
+        if (radiusMeters !== undefined) {
+          if (!Number.isFinite(radiusMeters) || radiusMeters <= 0) {
+            throw new Error("Invalid radiusMeters: ".concat(radiusMeters, ". Must be a positive finite number."));
+          }
+        }
+        _circle.coordinate = {
+          lat: center.lat,
+          lng: center.lng
+        };
+        if (radiusMeters !== undefined) {
+          _circle.radiusMeters = radiusMeters;
+        }
+        this.refreshCircles();
+        this.logEvent("updateCirclePosition");
+        return true;
+      } catch (error) {
+        throw new Error("Failed to update circle position: ".concat(error instanceof Error ? error.message : String(error)));
+      }
+    }
+  }, {
+    key: "updateCircleStyle",
+    value: function updateCircleStyle(circleId, style) {
+      try {
+        var _circle2 = this.circles.find(function (c) {
+          return c.id === circleId;
+        });
+        if (_circle2 === undefined) return false;
+
+        // Update only style properties, clamp opacities
+        if (style.fillColor !== undefined) _circle2.fillColor = style.fillColor;
+        if (style.fillOpacity !== undefined) _circle2.fillOpacity = Math.max(0, Math.min(1, style.fillOpacity));
+        if (style.strokeColor !== undefined) _circle2.strokeColor = style.strokeColor;
+        if (style.strokeWidth !== undefined) _circle2.strokeWidth = style.strokeWidth;
+        if (style.strokeOpacity !== undefined) _circle2.strokeOpacity = Math.max(0, Math.min(1, style.strokeOpacity));
+        this.refreshCircles();
+        this.logEvent("updateCircleStyle");
+        return true;
+      } catch (error) {
+        throw new Error("Failed to update circle style: ".concat(error instanceof Error ? error.message : String(error)));
+      }
+    }
+  }, {
+    key: "removeCircle",
+    value: function removeCircle(circleId) {
+      try {
+        this.circles = this.circles.filter(function (c) {
+          return c.id !== circleId;
+        });
+        this.refreshCircles();
+        this.logEvent("removeCircle");
+      } catch (error) {
+        throw new Error("Failed to remove circle");
+      }
+    }
+  }, {
+    key: "removeAllCircles",
+    value: function removeAllCircles() {
+      try {
+        this.circles = [];
+        this.refreshCircles();
+        this.logEvent("removeAllCircles");
+      } catch (error) {
+        throw new Error("Failed to remove all circles");
+      }
+    }
+  }, {
+    key: "showCircle",
+    value: function showCircle(circleId) {
+      try {
+        var _circle3 = this.circles.find(function (c) {
+          return c.id === circleId;
+        });
+        if (_circle3 === undefined) {
+          return false;
+        }
+        _circle3.hidden = false;
+        this.refreshCircles();
+        this.logEvent("showCircle");
+        return true;
+      } catch (error) {
+        return false;
+      }
+    }
+  }, {
+    key: "hideCircle",
+    value: function hideCircle(circleId) {
+      try {
+        var _circle4 = this.circles.find(function (c) {
+          return c.id === circleId;
+        });
+        if (_circle4 === undefined) {
+          return false;
+        }
+        _circle4.hidden = true;
+        this.refreshCircles();
+        this.logEvent("hideCircle");
+        return true;
+      } catch (error) {
+        return false;
+      }
+    }
+
+    /**
+     * Builds the GeoJSON FeatureCollection for every currently visible circle.
+     * Visibility mirrors marker semantics: a circle with a floor is shown only
+     * while that floor is displayed, and a circle without a floor is shown only
+     * in outdoor contexts. Hidden circles are always omitted.
+     */
+  }, {
+    key: "circleFeatureCollection",
+    value: function circleFeatureCollection() {
+      var _this$currentFloor3, _this$innerFloors$fin6, _this$innerFloors$fin7;
+      var floorId = (_this$currentFloor3 = this.currentFloor) !== null && _this$currentFloor3 !== void 0 ? _this$currentFloor3 : "";
+      var isOutdoor = !this.parentPlace || ((_this$innerFloors$fin6 = (_this$innerFloors$fin7 = this.innerFloors.find(function (floor) {
+        return floor.key === floorId;
+      })) === null || _this$innerFloors$fin7 === void 0 ? void 0 : _this$innerFloors$fin7.reachableFromGPS) !== null && _this$innerFloors$fin6 !== void 0 ? _this$innerFloors$fin6 : false);
+      var features = this.circles.filter(function (circle) {
+        var _circle$floorId;
+        if (circle.hidden) return false;
+        var circleFloor = (_circle$floorId = circle.floorId) !== null && _circle$floorId !== void 0 ? _circle$floorId : "";
+        return circleFloor === floorId || isOutdoor && circleFloor === "";
+      }).map(function (circle) {
+        return {
+          type: "Feature",
+          properties: {
+            id: circle.id,
+            fillColor: circle.fillColor,
+            fillOpacity: circle.fillOpacity,
+            strokeColor: circle.strokeColor,
+            strokeWidth: circle.strokeWidth,
+            strokeOpacity: circle.strokeOpacity,
+            renderOrder: circle.renderOrder
+          },
+          geometry: {
+            type: "Polygon",
+            coordinates: [circleRing(circle.coordinate.lng, circle.coordinate.lat, circle.radiusMeters)]
+          }
+        };
+      });
+      return {
+        type: "FeatureCollection",
+        features: features
+      };
+    }
+
+    /**
+     * Idempotently adds the shared circle source and its fill/line layers.
+     * Layers are inserted below the first symbol layer so place labels and
+     * markers stay readable above the translucent fill. Safe to call at any
+     * time: a style that is still loading simply rejects the calls, and the
+     * styledata listener retries once the style is ready.
+     */
+    /**
+     * Resolves the layer id to insert circle layers before, for one render
+     * order. `undefined` means "append on top".
+     *
+     * `aboveBasemap` finds the topmost non-symbol layer of the style and
+     * inserts before the first symbol layer that follows it. On indoor styles
+     * the floor-plate and building polygons are ordered after the first symbol
+     * layer, so anchoring on the topmost geometry layer — instead of the first
+     * symbol layer — guarantees circles are never occluded by basemap fills
+     * while still rendering below the labels that follow them.
+     */
+  }, {
+    key: "circleBeforeIdFor",
+    value: function circleBeforeIdFor(order) {
+      var _this$map$getStyle$la2, _this$map$getStyle2, _layers$slice$find;
+      if (order === "top") return undefined;
+      var layers = ((_this$map$getStyle$la2 = (_this$map$getStyle2 = this.map.getStyle()) === null || _this$map$getStyle2 === void 0 ? void 0 : _this$map$getStyle2.layers) !== null && _this$map$getStyle$la2 !== void 0 ? _this$map$getStyle$la2 : []).filter(function (layer) {
+        return !isCircleLayerId(layer.id);
+      });
+      if (order === "belowLabels") {
+        var _layers$find;
+        return (_layers$find = layers.find(function (layer) {
+          return layer.type === "symbol";
+        })) === null || _layers$find === void 0 ? void 0 : _layers$find.id;
+      }
+
+      // aboveBasemap
+      var lastNonSymbolIndex = -1;
+      layers.forEach(function (layer, index) {
+        if (layer.type !== "symbol") lastNonSymbolIndex = index;
+      });
+      return (_layers$slice$find = layers.slice(lastNonSymbolIndex + 1).find(function (layer) {
+        return layer.type === "symbol";
+      })) === null || _layers$slice$find === void 0 ? void 0 : _layers$slice$find.id;
+    }
+
+    /**
+     * Idempotently ensures the shared circle source and one fill/line layer
+     * pair per render order in use, at the placement that order requires.
+     * Placement is recomputed and re-asserted (via moveLayer) on every call,
+     * so circles regain their correct z-order after any style reload or
+     * floor/parent-place change. Safe to call at any time: a style that is
+     * still loading simply rejects the calls, and the styledata listener
+     * retries once the style is ready.
+     */
+  }, {
+    key: "ensureCircleLayers",
+    value: function ensureCircleLayers() {
+      if (!this.map) return;
+      try {
+        if (!this.map.getSource(CIRCLE_SOURCE_ID)) {
+          this.map.addSource(CIRCLE_SOURCE_ID, {
+            type: "geojson",
+            data: this.circleFeatureCollection()
+          });
+        }
+        var ordersInUse = new Set(this.circles.map(function (c) {
+          return c.renderOrder;
+        }));
+        // Always keep the default bucket alive so an empty map still renders
+        // newly added circles without a layer rebuild
+        ordersInUse.add("aboveBasemap");
+
+        // Process buckets lowest-first (CIRCLE_RENDER_ORDERS is canonical):
+        // when two buckets resolve to the same anchor, each addLayer/moveLayer
+        // lands immediately before it, so a bucket processed later paints above
+        // the ones processed earlier. Canonical order keeps
+        // belowLabels < aboveBasemap < top regardless of circle insertion order.
+        var _iterator = map_createForOfIteratorHelper(CIRCLE_RENDER_ORDERS),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var order = _step.value;
+            if (!ordersInUse.has(order)) continue;
+            var ids = circleLayerIdsFor(order);
+            var beforeId = this.circleBeforeIdFor(order);
+            var orderFilter = ["==", ["get", "renderOrder"], order];
+            if (!this.map.getLayer(ids.fill)) {
+              var fillLayer = {
+                id: ids.fill,
+                type: "fill",
+                source: CIRCLE_SOURCE_ID,
+                filter: orderFilter,
+                paint: {
+                  "fill-color": ["get", "fillColor"],
+                  "fill-opacity": ["get", "fillOpacity"]
+                }
+              };
+              this.map.addLayer(fillLayer, beforeId);
+            } else {
+              this.map.moveLayer(ids.fill, beforeId);
+            }
+            if (!this.map.getLayer(ids.line)) {
+              var lineLayer = {
+                id: ids.line,
+                type: "line",
+                source: CIRCLE_SOURCE_ID,
+                filter: orderFilter,
+                paint: {
+                  "line-color": ["get", "strokeColor"],
+                  "line-width": ["get", "strokeWidth"],
+                  "line-opacity": ["get", "strokeOpacity"]
+                }
+              };
+              this.map.addLayer(lineLayer, beforeId);
+            } else {
+              this.map.moveLayer(ids.line, beforeId);
+            }
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+      } catch (error) {
+        // Style may not be loaded yet; the styledata listener re-adds the layers
+      }
+    }
+
+    /**
+     * Re-renders all circles: ensures the source and layers exist, then pushes
+     * the current FeatureCollection. Called after every mutation of the circle
+     * list, on floor changes, and when the map style reloads.
+     */
+  }, {
+    key: "refreshCircles",
+    value: function refreshCircles() {
+      if (!this.map) return;
+      if (this.circles.length === 0 && !this.map.getSource(CIRCLE_SOURCE_ID)) return;
+      this.ensureCircleLayers();
+      try {
+        var source = this.map.getSource(CIRCLE_SOURCE_ID);
+        source === null || source === void 0 || source.setData(this.circleFeatureCollection());
+      } catch (error) {
+        // Source may not exist while a new style is loading
+      }
+    }
 
     /**
      * Use it to change the current layer
@@ -13903,6 +14935,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
       }
       this.updateFiltersTo(floorKeyString);
       this.updateMarkersTo(floorKeyString);
+      this.refreshCircles();
       this.routeController.updateRouteLayers(floorKeyString);
       this.routeController.updateRouteMarkerVisibility(floorKeyString);
     }
@@ -13914,33 +14947,33 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "updateMarkersTo",
     value: function updateMarkersTo(floorId) {
-      var _this$innerFloors$fin6,
-        _this$innerFloors$fin7,
-        _this1 = this;
-      var isOutdoor = !this.parentPlace || ((_this$innerFloors$fin6 = (_this$innerFloors$fin7 = this.innerFloors.find(function (floor) {
+      var _this$innerFloors$fin8,
+        _this$innerFloors$fin9,
+        _this10 = this;
+      var isOutdoor = !this.parentPlace || ((_this$innerFloors$fin8 = (_this$innerFloors$fin9 = this.innerFloors.find(function (floor) {
         return floor.key === floorId;
-      })) === null || _this$innerFloors$fin7 === void 0 ? void 0 : _this$innerFloors$fin7.reachableFromGPS) !== null && _this$innerFloors$fin6 !== void 0 ? _this$innerFloors$fin6 : false);
+      })) === null || _this$innerFloors$fin9 === void 0 ? void 0 : _this$innerFloors$fin9.reachableFromGPS) !== null && _this$innerFloors$fin8 !== void 0 ? _this$innerFloors$fin8 : false);
       this.markers.forEach(function (e) {
-        e.changeFloor(floorId, _this1.map, isOutdoor);
+        e.changeFloor(floorId, _this10.map, isOutdoor);
       });
     }
   }, {
     key: "updateFiltersTo",
     value: function updateFiltersTo(floorId) {
-      var _this$map$getStyle$la2,
-        _this$map$getStyle2,
-        _this10 = this,
-        _this$innerFloors$fin8;
+      var _this$map$getStyle$la3,
+        _this$map$getStyle3,
+        _this11 = this,
+        _this$innerFloors$fin0;
       if (!this.map) return;
-      var layers = (_this$map$getStyle$la2 = (_this$map$getStyle2 = this.map.getStyle()) === null || _this$map$getStyle2 === void 0 ? void 0 : _this$map$getStyle2.layers) !== null && _this$map$getStyle$la2 !== void 0 ? _this$map$getStyle$la2 : [];
+      var layers = (_this$map$getStyle$la3 = (_this$map$getStyle3 = this.map.getStyle()) === null || _this$map$getStyle3 === void 0 ? void 0 : _this$map$getStyle3.layers) !== null && _this$map$getStyle$la3 !== void 0 ? _this$map$getStyle$la3 : [];
       layers.filter(function (l) {
         return l.id.startsWith("base-indoor-");
       }).forEach(function (l) {
-        _this10.map.removeLayer(l.id);
+        _this11.map.removeLayer(l.id);
       });
-      var baseFloorId = (_this$innerFloors$fin8 = this.innerFloors.find(function (floor) {
+      var baseFloorId = (_this$innerFloors$fin0 = this.innerFloors.find(function (floor) {
         return floor.key === floorId;
-      })) === null || _this$innerFloors$fin8 === void 0 ? void 0 : _this$innerFloors$fin8.baseFloor;
+      })) === null || _this$innerFloors$fin0 === void 0 ? void 0 : _this$innerFloors$fin0.baseFloor;
       var indoorLayers = layers.filter(function (layer) {
         return layer.id.startsWith("indoor-");
       });
@@ -13952,13 +14985,13 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         }).forEach(function (layer) {
           var baseLayer = deepClone(layer);
           baseLayer.id = "base-" + layer.id;
-          _this10.baseFilters[baseLayer.id] = _this10.baseFilters[layer.id];
-          _this10.map.addLayer(baseLayer, firstLayerId);
-          _this10.applyLayerFilters(baseLayer, baseFloorId);
+          _this11.baseFilters[baseLayer.id] = _this11.baseFilters[layer.id];
+          _this11.map.addLayer(baseLayer, firstLayerId);
+          _this11.applyLayerFilters(baseLayer, baseFloorId);
         });
       }
       indoorLayers.forEach(function (layer) {
-        _this10.applyLayerFilters(layer, floorId);
+        _this11.applyLayerFilters(layer, floorId);
       });
     }
   }, {
@@ -14018,6 +15051,57 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
       this.map.setMinZoom(zoomLvl);
       options === null || options === void 0 || (_options$onComplete3 = options.onComplete) === null || _options$onComplete3 === void 0 || _options$onComplete3.call(options);
     }
+  }, {
+    key: "setBearing",
+    value: function setBearing(degrees, options) {
+      var _options$onComplete4;
+      if (!Number.isFinite(degrees)) return;
+      if (options !== null && options !== void 0 && options.animate) {
+        if (options.onComplete) void this.map.once("moveend", options.onComplete);
+        this.map.rotateTo(degrees, {
+          duration: 600
+        });
+        return;
+      }
+      this.map.setBearing(degrees);
+      options === null || options === void 0 || (_options$onComplete4 = options.onComplete) === null || _options$onComplete4 === void 0 || _options$onComplete4.call(options);
+    }
+  }, {
+    key: "setRotationEnabled",
+    value: function setRotationEnabled(enabled) {
+      if (enabled) {
+        var _this$map$dragRotate, _this$map$dragRotate$, _this$map$touchZoomRo3, _this$map$touchZoomRo4, _this$map$keyboard, _this$map$keyboard$en;
+        (_this$map$dragRotate = this.map.dragRotate) === null || _this$map$dragRotate === void 0 || (_this$map$dragRotate$ = _this$map$dragRotate.enable) === null || _this$map$dragRotate$ === void 0 || _this$map$dragRotate$.call(_this$map$dragRotate);
+        (_this$map$touchZoomRo3 = this.map.touchZoomRotate) === null || _this$map$touchZoomRo3 === void 0 || (_this$map$touchZoomRo4 = _this$map$touchZoomRo3.enableRotation) === null || _this$map$touchZoomRo4 === void 0 || _this$map$touchZoomRo4.call(_this$map$touchZoomRo3);
+        (_this$map$keyboard = this.map.keyboard) === null || _this$map$keyboard === void 0 || (_this$map$keyboard$en = _this$map$keyboard.enable) === null || _this$map$keyboard$en === void 0 || _this$map$keyboard$en.call(_this$map$keyboard);
+      } else {
+        var _this$map$dragRotate2, _this$map$dragRotate3, _this$map$touchZoomRo5, _this$map$touchZoomRo6;
+        (_this$map$dragRotate2 = this.map.dragRotate) === null || _this$map$dragRotate2 === void 0 || (_this$map$dragRotate3 = _this$map$dragRotate2.disable) === null || _this$map$dragRotate3 === void 0 || _this$map$dragRotate3.call(_this$map$dragRotate2);
+        (_this$map$touchZoomRo5 = this.map.touchZoomRotate) === null || _this$map$touchZoomRo5 === void 0 || (_this$map$touchZoomRo6 = _this$map$touchZoomRo5.disableRotation) === null || _this$map$touchZoomRo6 === void 0 || _this$map$touchZoomRo6.call(_this$map$touchZoomRo5);
+      }
+    }
+  }, {
+    key: "setPanEnabled",
+    value: function setPanEnabled(enabled) {
+      if (enabled) {
+        var _this$map$dragPan, _this$map$dragPan$ena;
+        (_this$map$dragPan = this.map.dragPan) === null || _this$map$dragPan === void 0 || (_this$map$dragPan$ena = _this$map$dragPan.enable) === null || _this$map$dragPan$ena === void 0 || _this$map$dragPan$ena.call(_this$map$dragPan);
+      } else {
+        var _this$map$dragPan2, _this$map$dragPan2$di;
+        (_this$map$dragPan2 = this.map.dragPan) === null || _this$map$dragPan2 === void 0 || (_this$map$dragPan2$di = _this$map$dragPan2.disable) === null || _this$map$dragPan2$di === void 0 || _this$map$dragPan2$di.call(_this$map$dragPan2);
+      }
+    }
+  }, {
+    key: "setScrollZoomEnabled",
+    value: function setScrollZoomEnabled(enabled) {
+      if (enabled) {
+        var _this$map$scrollZoom, _this$map$scrollZoom$;
+        (_this$map$scrollZoom = this.map.scrollZoom) === null || _this$map$scrollZoom === void 0 || (_this$map$scrollZoom$ = _this$map$scrollZoom.enable) === null || _this$map$scrollZoom$ === void 0 || _this$map$scrollZoom$.call(_this$map$scrollZoom);
+      } else {
+        var _this$map$scrollZoom2, _this$map$scrollZoom3;
+        (_this$map$scrollZoom2 = this.map.scrollZoom) === null || _this$map$scrollZoom2 === void 0 || (_this$map$scrollZoom3 = _this$map$scrollZoom2.disable) === null || _this$map$scrollZoom3 === void 0 || _this$map$scrollZoom3.call(_this$map$scrollZoom2);
+      }
+    }
   }, {
     key: "isInsideBounds",
     value: function isInsideBounds(point) {
@@ -14030,12 +15114,12 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "setMaxBounds",
     value: function setMaxBounds(coordinates, options) {
-      var _options$onComplete4;
+      var _options$onComplete5;
       if (coordinates.length > 1) {
         var boundingBox = getBoundingBox(coordinates);
         this.map.setMaxBounds(new maplibre_gl.LngLatBounds([boundingBox[0].lng, boundingBox[0].lat], [boundingBox[1].lng, boundingBox[1].lat]));
       }
-      options === null || options === void 0 || (_options$onComplete4 = options.onComplete) === null || _options$onComplete4 === void 0 || _options$onComplete4.call(options);
+      options === null || options === void 0 || (_options$onComplete5 = options.onComplete) === null || _options$onComplete5 === void 0 || _options$onComplete5.call(options);
     }
   }, {
     key: "fitCoordinates",
@@ -14059,11 +15143,11 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         var minLng;
         var maxLat;
         var maxLng;
-        var _iterator = map_createForOfIteratorHelper(coordinates),
-          _step;
+        var _iterator2 = map_createForOfIteratorHelper(coordinates),
+          _step2;
         try {
-          for (_iterator.s(); !(_step = _iterator.n()).done;) {
-            var _coord = _step.value;
+          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+            var _coord = _step2.value;
             var lat = _coord.lat,
               lng = _coord.lng;
             minLat = minLat === undefined ? lat : Math.min(minLat, lat);
@@ -14072,9 +15156,9 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
             maxLng = maxLng === undefined ? lng : Math.max(maxLng, lng);
           }
         } catch (err) {
-          _iterator.e(err);
+          _iterator2.e(err);
         } finally {
-          _iterator.f();
+          _iterator2.f();
         }
         var bounds = [minLng !== null && minLng !== void 0 ? minLng : 0, minLat !== null && minLat !== void 0 ? minLat : 0, maxLng !== null && maxLng !== void 0 ? maxLng : 0, maxLat !== null && maxLat !== void 0 ? maxLat : 0];
 
@@ -14126,13 +15210,13 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
     key: "updateFloor",
     value: function updateFloor(floorId, options) {
       try {
-        var _this$onFloorChange2, _options$onComplete5;
+        var _this$onFloorChange2, _options$onComplete6;
         this.filterByFloorKey(floorId);
         (_this$onFloorChange2 = this.onFloorChange) === null || _this$onFloorChange2 === void 0 || _this$onFloorChange2.call(this, floorId);
         this.logEvent("updateFloor", {
           floorId: floorId
         });
-        options === null || options === void 0 || (_options$onComplete5 = options.onComplete) === null || _options$onComplete5 === void 0 || _options$onComplete5.call(options);
+        options === null || options === void 0 || (_options$onComplete6 = options.onComplete) === null || _options$onComplete6 === void 0 || _options$onComplete6.call(options);
       } catch (error) {
         // Floor update may fail
       }
@@ -14196,7 +15280,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
     value: function updateRouteProgress(routeId, position) {
       var behindStyle = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {
         type: "Solid",
-        color: "#757575"
+        color: "#276EF1"
       };
       try {
         var behindConfig = new InternalDrawRouteConfiguration({
@@ -14251,13 +15335,11 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
           return subplace.clientId === placeId || subplace.mapvxId === placeId;
         });
         if (pointedPlace !== undefined) {
-          new (maplibre_gl_default()).Popup().setLngLat(pointedPlace.position).setHTML(pointedPlace.title).addTo(this.map);
+          new (maplibre_gl_default()).Popup().setLngLat(pointedPlace.position).setText(pointedPlace.title).addTo(this.map);
         }
       }
       return "";
     }
-
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
   }, {
     key: "removePopOver",
     value: function removePopOver(id) {
@@ -14276,17 +15358,17 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "defaultClickListener",
     value: function defaultClickListener() {
-      var _this11 = this;
+      var _this12 = this;
       this.map.on("click", /*#__PURE__*/function () {
         var _ref4 = map_asyncToGenerator(/*#__PURE__*/map_regenerator().m(function _callee2(e) {
-          var features, roomFeatures, touchedFeature, ref, _clickedPlace, _ref5, _clickedPlace$mapvxId, _clickedPlace2, _clickedPlace3, clickedPlace, _iterator2, _step2, potentialParentPlace, cachedSubPlaces, cachedPlaces, clickedPlaceId, _t2;
+          var features, roomFeatures, touchedFeature, ref, _clickedPlace, _ref5, _clickedPlace$mapvxId, _clickedPlace2, _clickedPlace3, clickedPlace, _iterator3, _step3, potentialParentPlace, cachedSubPlaces, cachedPlaces, clickedPlaceId, _t2;
           return map_regenerator().w(function (_context2) {
             while (1) switch (_context2.p = _context2.n) {
               case 0:
-                features = _this11.map.queryRenderedFeatures(e.point); // Filter room features by current floor
+                features = _this12.map.queryRenderedFeatures(e.point); // Filter room features by current floor
                 roomFeatures = features.filter(function (feature) {
                   var _feature$properties;
-                  return feature.properties["class"] === "room" && ((_feature$properties = feature.properties) === null || _feature$properties === void 0 ? void 0 : _feature$properties.floor_key) === _this11.currentFloor;
+                  return feature.properties["class"] === "room" && ((_feature$properties = feature.properties) === null || _feature$properties === void 0 ? void 0 : _feature$properties.floor_key) === _this12.currentFloor;
                 });
                 touchedFeature = roomFeatures[0];
                 ref = touchedFeature === null || touchedFeature === void 0 ? void 0 : touchedFeature.properties.ref;
@@ -14297,23 +15379,23 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
                 console.log("touchedFeature", ref);
 
                 // First, search in current subPlaces
-                clickedPlace = _this11.subPlaces.find(function (subPlace) {
+                clickedPlace = _this12.subPlaces.find(function (subPlace) {
                   return subPlace.mapvxId === ref;
                 }); // If not found, search in subplaces of potential parent places
                 if (!(clickedPlace === undefined)) {
                   _context2.n = 7;
                   break;
                 }
-                _iterator2 = map_createForOfIteratorHelper(_this11.potentialParentPlaces);
+                _iterator3 = map_createForOfIteratorHelper(_this12.potentialParentPlaces);
                 _context2.p = 1;
-                _iterator2.s();
+                _iterator3.s();
               case 2:
-                if ((_step2 = _iterator2.n()).done) {
+                if ((_step3 = _iterator3.n()).done) {
                   _context2.n = 4;
                   break;
                 }
-                potentialParentPlace = _step2.value;
-                cachedSubPlaces = _this11.repository.getCachedSubPlaces(potentialParentPlace.mapvxId);
+                potentialParentPlace = _step3.value;
+                cachedSubPlaces = _this12.repository.getCachedSubPlaces(potentialParentPlace.mapvxId);
                 if (!cachedSubPlaces) {
                   _context2.n = 3;
                   break;
@@ -14335,24 +15417,24 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
               case 5:
                 _context2.p = 5;
                 _t2 = _context2.v;
-                _iterator2.e(_t2);
+                _iterator3.e(_t2);
               case 6:
                 _context2.p = 6;
-                _iterator2.f();
+                _iterator3.f();
                 return _context2.f(6);
               case 7:
                 if (!(clickedPlace === undefined)) {
                   _context2.n = 10;
                   break;
                 }
-                cachedPlaces = _this11.repository.getCachedPlaces([ref]);
+                cachedPlaces = _this12.repository.getCachedPlaces([ref]);
                 if (!(cachedPlaces.length === 0)) {
                   _context2.n = 9;
                   break;
                 }
                 console.log("fetching place detail from server", ref);
                 _context2.n = 8;
-                return _this11.repository.fetchAndParsePlaceDetail(ref);
+                return _this12.repository.fetchAndParsePlaceDetail(ref);
               case 8:
                 clickedPlace = _context2.v;
                 _context2.n = 10;
@@ -14363,8 +15445,8 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
               case 10:
                 console.log("clickedPlace", (_clickedPlace = clickedPlace) === null || _clickedPlace === void 0 ? void 0 : _clickedPlace.title);
                 clickedPlaceId = (_ref5 = (_clickedPlace$mapvxId = (_clickedPlace2 = clickedPlace) === null || _clickedPlace2 === void 0 ? void 0 : _clickedPlace2.mapvxId) !== null && _clickedPlace$mapvxId !== void 0 ? _clickedPlace$mapvxId : (_clickedPlace3 = clickedPlace) === null || _clickedPlace3 === void 0 ? void 0 : _clickedPlace3.clientId) !== null && _ref5 !== void 0 ? _ref5 : "";
-                if (clickedPlace !== undefined && _this11.clickCallback) {
-                  _this11.clickCallback(clickedPlaceId);
+                if (clickedPlace !== undefined && _this12.clickCallback) {
+                  _this12.clickCallback(clickedPlaceId);
                 }
               case 11:
                 return _context2.a(2);
@@ -14379,29 +15461,29 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "onHover",
     value: function onHover() {
-      var _this12 = this;
+      var _this13 = this;
       if (!this.enableHover) return;
       this.map.on("mousemove", "hoverable", function (e) {
         var _e$features;
         var feature = (_e$features = e.features) === null || _e$features === void 0 ? void 0 : _e$features.find(function (feature) {
           var _feature$properties$r, _feature$properties2;
-          return ((_feature$properties$r = feature.properties.ref) === null || _feature$properties$r === void 0 ? void 0 : _feature$properties$r.length) > 0 && ((_feature$properties2 = feature.properties) === null || _feature$properties2 === void 0 ? void 0 : _feature$properties2.floor_key) === _this12.currentFloor;
+          return ((_feature$properties$r = feature.properties.ref) === null || _feature$properties$r === void 0 ? void 0 : _feature$properties$r.length) > 0 && ((_feature$properties2 = feature.properties) === null || _feature$properties2 === void 0 ? void 0 : _feature$properties2.floor_key) === _this13.currentFloor;
         });
         var ref = feature === null || feature === void 0 ? void 0 : feature.properties.ref;
         if (ref != null && typeof ref === "string" && ref.length > 0) {
-          _this12.hoveredId = ref;
-          _this12.updateFiltersTo(_this12.currentFloor);
-        } else if (ref === undefined && _this12.hoveredId !== "unselected") {
-          _this12.hoveredId = "unselected";
-          _this12.updateFiltersTo(_this12.currentFloor);
+          _this13.hoveredId = ref;
+          _this13.updateFiltersTo(_this13.currentFloor);
+        } else if (ref === undefined && _this13.hoveredId !== "unselected") {
+          _this13.hoveredId = "unselected";
+          _this13.updateFiltersTo(_this13.currentFloor);
         }
       });
 
       // When the mouse leaves the state-fill layer, update the feature state of the
       // previously hovered feature.
       this.map.on("mouseleave", "hoverable", function () {
-        _this12.hoveredId = "unselected";
-        _this12.updateFiltersTo(_this12.currentFloor);
+        _this13.hoveredId = "unselected";
+        _this13.updateFiltersTo(_this13.currentFloor);
       });
     }
   }, {
@@ -14457,7 +15539,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
           filter: ["all", ["has", "ref"], ["==", ["get", "ref"], "unselected"]],
           paint: {
             "fill-extrusion-height": 2.5,
-            "fill-extrusion-color": "#276EF1",
+            "fill-extrusion-color": MAPVX_BRAND_COLOR,
             "fill-extrusion-opacity": 0.8
           }
         };
@@ -14470,7 +15552,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
           "source-layer": "area",
           filter: ["all", ["has", "ref"], ["==", ["get", "ref"], "unselected"]],
           paint: {
-            "fill-color": "#276EF1"
+            "fill-color": MAPVX_BRAND_COLOR
           }
         };
         this.map.addLayer(_layer);
@@ -14479,10 +15561,10 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "createBasicFilters",
     value: function createBasicFilters() {
-      var _this$parentPlaceId3, _this$currentFloor3;
+      var _this$parentPlaceId3, _this$currentFloor4;
       var publicPlaceFilter = ["==", ["get", "public_place"], true];
       var subPlaceFilter = ["!", ["in", (_this$parentPlaceId3 = this.parentPlaceId) !== null && _this$parentPlaceId3 !== void 0 ? _this$parentPlaceId3 : "noRef", ["get", "is_subplace"]]];
-      var floorId = (_this$currentFloor3 = this.currentFloor) !== null && _this$currentFloor3 !== void 0 ? _this$currentFloor3 : "noRef";
+      var floorId = (_this$currentFloor4 = this.currentFloor) !== null && _this$currentFloor4 !== void 0 ? _this$currentFloor4 : "noRef";
       var floorFilter = ["in", floorId, ["get", "floor_key"]];
       var showInFloorFilter = ["in", floorId, ["get", "show_in_floor"]];
       var basicFilters = publicPlaceFilter;
@@ -14864,7 +15946,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         "source-layer": "area",
         filter: ["all", ["has", "ref"], ["==", ["get", "ref"], "unselected"]],
         paint: {
-          "line-color": "#276EF1",
+          "line-color": MAPVX_BRAND_COLOR,
           "line-width": 4
         }
       };
@@ -14883,7 +15965,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
     key: "onWebGLContextLost",
     value: function onWebGLContextLost(e) {
       var _this$map,
-        _this13 = this;
+        _this14 = this;
       e.originalEvent.preventDefault();
       console.warn("Contexto WebGL perdido 😢");
 
@@ -14894,8 +15976,8 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         var _ext$restoreContext;
         canvas.addEventListener("webglcontextrestored", function () {
           console.debug("Contexto WebGL restaurado, forzando re-render");
-          _this13.map.triggerRepaint(); // forzar repaint
-          _this13.failedTiles.clear();
+          _this14.map.triggerRepaint(); // forzar repaint
+          _this14.failedTiles.clear();
         }, {
           once: true
         });
@@ -14935,7 +16017,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "subscribeToFailedTiles",
     value: function subscribeToFailedTiles() {
-      var _this14 = this;
+      var _this15 = this;
       if (this.retryTimer) return;
 
       // Store bound functions for proper cleanup
@@ -14944,20 +16026,20 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
       this.boundOnWebGLContextLost = this.onWebGLContextLost.bind(this);
       this.boundOnWebGLContextRestored = this.onWebGLContextRestored.bind(this);
       this.retryTimer = setInterval(function () {
-        if (!_this14.map.getSource("indoorequal")) {
-          _this14.failedTiles.clear();
+        if (!_this15.map.getSource("indoorequal")) {
+          _this15.failedTiles.clear();
           return;
         }
-        var source = _this14.map.getSource("indoorequal");
+        var source = _this15.map.getSource("indoorequal");
         if (!source || source.type !== "vector") {
-          _this14.failedTiles.clear();
+          _this15.failedTiles.clear();
           return;
         }
 
         // Process tiles and remove invalid ones
         var tilesToRetry = [];
         var tilesToRemove = [];
-        _this14.failedTiles.forEach(function (tile) {
+        _this15.failedTiles.forEach(function (tile) {
           // Check if tile is still valid before attempting reload
           if (!tile || tile.state === "unloaded" || tile.state === "loading") {
             tilesToRemove.push(tile);
@@ -14975,7 +16057,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
 
         // Remove invalid tiles from the set
         tilesToRemove.forEach(function (tile) {
-          return _this14.failedTiles["delete"](tile);
+          return _this15.failedTiles["delete"](tile);
         });
 
         // Attempt to reload valid failed tiles
@@ -14987,7 +16069,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
             }
           } catch (error) {
             // If reload fails, remove tile from retry queue - this is expected
-            _this14.failedTiles["delete"](tile);
+            _this15.failedTiles["delete"](tile);
           }
         });
       }, 1000);
@@ -15136,6 +16218,7 @@ var InternalMapVXSDK = /*#__PURE__*/function (_Loggeable) {
     var _this;
     sdk_classCallCheck(this, InternalMapVXSDK);
     _this = sdk_callSuper(this, InternalMapVXSDK);
+    sdk_defineProperty(_this, "maps", []);
     sdk_defineProperty(_this, "geoLocation", navigator.geolocation);
     sdk_defineProperty(_this, "headingListeners", []);
     _this.token = token;
@@ -15169,6 +16252,17 @@ var InternalMapVXSDK = /*#__PURE__*/function (_Loggeable) {
     value: function setSdkLang(lang) {
       this.config.lang = lang;
       this.repository.setLang(lang);
+      this.maps.forEach(function (map) {
+        return map.setLang(lang);
+      });
+    }
+  }, {
+    key: "unregisterMap",
+    value: function unregisterMap(map) {
+      var mapIndex = this.maps.indexOf(map);
+      if (mapIndex >= 0) {
+        this.maps.splice(mapIndex, 1);
+      }
     }
   }, {
     key: "getPlaceDetail",
@@ -15242,11 +16336,21 @@ var InternalMapVXSDK = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "createMap",
     value: function createMap(container, mapConfig) {
+      var _this2 = this;
       try {
         mapConfig.lang = this.config.lang;
         mapConfig.apiUrl = this.config.apiUrl;
         mapConfig.mapvxRequestContext = this.config.mapvxRequestContext;
         var map = new InternalMapVXMap(mapConfig, container, this.token);
+        var originalDestroyMap = map.destroyMap.bind(map);
+        map.destroyMap = function () {
+          try {
+            originalDestroyMap();
+          } finally {
+            _this2.unregisterMap(map);
+          }
+        };
+        this.maps.push(map);
         this.logEvent("createMap");
         return map;
       } catch (error) {
@@ -15643,7 +16747,7 @@ var InternalMapVXSDK = /*#__PURE__*/function (_Loggeable) {
         return _searchPlacesByTags.apply(this, arguments);
       }
       return searchPlacesByTags;
-    }() // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    }()
   }, {
     key: "getPlacesByCategory",
     value: function () {
@@ -15679,14 +16783,14 @@ var InternalMapVXSDK = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "getUserLocation",
     value: function getUserLocation() {
-      var _this2 = this;
+      var _this3 = this;
       var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {
         enableHighAccuracy: true,
         timeout: 60 * 1000,
         maximumAge: 10 * 1000
       };
       return new Promise(function (resolve, reject) {
-        _this2.geoLocation.getCurrentPosition(function (position) {
+        _this3.geoLocation.getCurrentPosition(function (position) {
           resolve(position);
         }, function (error) {
           reject(error);
@@ -15890,13 +16994,29 @@ var InternalMapVXSDK = /*#__PURE__*/function (_Loggeable) {
  * @group Utils
  */
 
+/**
+ * Represents a category containing a image url.
+ * @group Utils
+ */
+
 /**
  * Represents a category containing an icon.
  * @group Utils
  */
 
 /**
- * Represents a basic category containing a logo or an icon.
+ * Holds the basic information of a category: its `id`, `name` and an optional `description`.
+ *
+ * A category may optionally carry a graphical representation, but it is not required.
+ * Depending on the available asset, a `BasicCategory` can be one of:
+ *
+ * - {@link BasicWithLogo} — the category provides a logo image (URL).
+ * - {@link BasicWithIcon} — the category provides a Font Awesome icon name (and optional style).
+ * - {@link BasicWithImageUrl} — the category provides an image URL for its icon.
+ * - {@link Basic} — the category carries no graphical information at all.
+ *
+ * Use the {@link isBasicWithLogo}, {@link isBasicWithIcon} and {@link isBasicWithImageUrl}
+ * type guards to narrow a `BasicCategory` and safely access its graphical asset.
  * @group Utils
  */
 
@@ -15950,132 +17070,36 @@ var InternalMapVXSDK = /*#__PURE__*/function (_Loggeable) {
  */
 
 /**
- * Checks if the category is a basic with logo.
- *  @group Utils
- * @param category
- * @returns
+ * Checks if the category carries a logo image.
+ * @group Utils
+ * @param category - The category to inspect.
+ * @returns `true` if the category exposes a non-empty `logo` URL, narrowing it to {@link BasicWithLogo}.
  */
 function isBasicWithLogo(category) {
-  return category.logo !== undefined;
+  var input = category;
+  return input.logo != null && input.logo !== "";
 }
 
 /**
- * Checks if the category is a basic with icon.
+ * Checks if the category carries a Font Awesome icon.
  * @group Utils
- * @param category
- * @returns
+ * @param category - The category to inspect.
+ * @returns `true` if the category exposes a non-empty `icon` name, narrowing it to {@link BasicWithIcon}.
  */
 function isBasicWithIcon(category) {
-  return category.icon !== undefined;
-}
-;// ./src/utils/update-css.ts
-function update_css_slicedToArray(r, e) { return update_css_arrayWithHoles(r) || update_css_iterableToArrayLimit(r, e) || update_css_unsupportedIterableToArray(r, e) || update_css_nonIterableRest(); }
-function update_css_nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function update_css_unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return update_css_arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? update_css_arrayLikeToArray(r, a) : void 0; } }
-function update_css_arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
-function update_css_iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
-function update_css_arrayWithHoles(r) { if (Array.isArray(r)) return r; }
-/**
- * Load a CSS customization of a project.
- *
- * This function create a new HTML Style Element and add it to the current document.
- * Also activate the customization adding the first theme name to the body of the document.
- *
- * @group Utils
- * @param data The CSS customization data.
- */
-function loadCustomization(data) {
-  var style = document.createElement("style");
-  style.textContent = "";
-  for (var _i = 0, _Object$entries = Object.entries(data); _i < _Object$entries.length; _i++) {
-    var _Object$entries$_i = update_css_slicedToArray(_Object$entries[_i], 2),
-      themeName = _Object$entries$_i[0],
-      themeData = _Object$entries$_i[1];
-    var cssClass = loadTheme(themeName, themeData);
-    style.textContent += cssClass;
-  }
-  document.head.appendChild(style);
-  var firstThemeName = Object.keys(data).at(0);
-  if (firstThemeName != null) {
-    document.body.classList.add(firstThemeName);
-  }
+  var input = category;
+  return input.icon != null && input.icon !== "";
 }
 
 /**
- * Process a theme.
- *
- * @group Utils
- * @param themeName The name of the Theme.
- * @param themeData The data of the Theme.
- * @returns A string with the processed theme to use on a CSS file.
- */
-function loadTheme(themeName, themeData) {
-  var cssClass = ".".concat(themeName, " {\n");
-  var definitions = themeData.definitions;
-  if (definitions != null) {
-    cssClass = loadDefinitions(definitions, cssClass);
-  }
-  for (var _i2 = 0, _Object$entries2 = Object.entries((_themeData$screens = themeData.screens) !== null && _themeData$screens !== void 0 ? _themeData$screens : {}); _i2 < _Object$entries2.length; _i2++) {
-    var _themeData$screens;
-    var _Object$entries2$_i = update_css_slicedToArray(_Object$entries2[_i2], 2),
-      screenName = _Object$entries2$_i[0],
-      screenData = _Object$entries2$_i[1];
-    for (var _i3 = 0, _Object$entries3 = Object.entries(screenData); _i3 < _Object$entries3.length; _i3++) {
-      var _Object$entries3$_i = update_css_slicedToArray(_Object$entries3[_i3], 2),
-        componentName = _Object$entries3$_i[0],
-        componentData = _Object$entries3$_i[1];
-      for (var _i4 = 0, _Object$entries4 = Object.entries(componentData); _i4 < _Object$entries4.length; _i4++) {
-        var _Object$entries4$_i = update_css_slicedToArray(_Object$entries4[_i4], 2),
-          elementName = _Object$entries4$_i[0],
-          elementData = _Object$entries4$_i[1];
-        for (var _i5 = 0, _Object$entries5 = Object.entries(elementData); _i5 < _Object$entries5.length; _i5++) {
-          var _Object$entries5$_i = update_css_slicedToArray(_Object$entries5[_i5], 2),
-            propertyName = _Object$entries5$_i[0],
-            propertyValue = _Object$entries5$_i[1];
-          cssClass += "  --".concat(screenName, "-").concat(componentName, "-").concat(elementName, "-").concat(propertyName, ": ").concat(propertyValue, ";\n");
-        }
-      }
-    }
-  }
-  cssClass += "}\n";
-  return cssClass;
-}
-/**
- * Process the definitions of a theme.
- *
+ * Checks if the category carries an image URL.
  * @group Utils
- * @param definitions The definitions of the theme.
- * @param cssClass The string object that will contain the processed theme
- * @returns The cssClass string mutated with the processed definitions.
+ * @param category - The category to inspect.
+ * @returns `true` if the category exposes a non-empty `imageUrl`, narrowing it to {@link BasicWithImageUrl}.
  */
-function loadDefinitions(definitions, cssClass) {
-  for (var _i6 = 0, _Object$entries6 = Object.entries((_definitions$colors = definitions.colors) !== null && _definitions$colors !== void 0 ? _definitions$colors : {}); _i6 < _Object$entries6.length; _i6++) {
-    var _definitions$colors;
-    var _Object$entries6$_i = update_css_slicedToArray(_Object$entries6[_i6], 2),
-      colorName = _Object$entries6$_i[0],
-      colorData = _Object$entries6$_i[1];
-    for (var _i7 = 0, _Object$entries7 = Object.entries(colorData); _i7 < _Object$entries7.length; _i7++) {
-      var _Object$entries7$_i = update_css_slicedToArray(_Object$entries7[_i7], 2),
-        colorIntensity = _Object$entries7$_i[0],
-        colorValue = _Object$entries7$_i[1];
-      cssClass += "  --definitions-colors-".concat(colorName, "-").concat(colorIntensity, ": ").concat(colorValue, ";\n");
-    }
-  }
-  for (var _i8 = 0, _Object$entries8 = Object.entries((_definitions$shadows = definitions.shadows) !== null && _definitions$shadows !== void 0 ? _definitions$shadows : {}); _i8 < _Object$entries8.length; _i8++) {
-    var _definitions$shadows;
-    var _Object$entries8$_i = update_css_slicedToArray(_Object$entries8[_i8], 2),
-      shadowName = _Object$entries8$_i[0],
-      shadowValue = _Object$entries8$_i[1];
-    cssClass += "  --definitions-shadows-".concat(shadowName, ": ").concat(shadowValue, ";\n");
-  }
-  for (var _i9 = 0, _Object$entries9 = Object.entries((_definitions$textFont = definitions.textFonts) !== null && _definitions$textFont !== void 0 ? _definitions$textFont : {}); _i9 < _Object$entries9.length; _i9++) {
-    var _definitions$textFont;
-    var _Object$entries9$_i = update_css_slicedToArray(_Object$entries9[_i9], 2),
-      fontName = _Object$entries9$_i[0],
-      fontValue = _Object$entries9$_i[1];
-    cssClass += "  --definitions-textFonts-".concat(fontName, ": ").concat(fontValue, ";\n");
-  }
-  return cssClass;
+function isBasicWithImageUrl(category) {
+  var input = category;
+  return input.imageUrl != null && input.imageUrl !== "";
 }
 ;// ./src/utils/opening-hours-helper.ts
 function opening_hours_helper_createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = opening_hours_helper_unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
@@ -17217,6 +18241,115 @@ function normalizeOrigin(raw) {
     return null;
   }
 }
+;// ./src/utils/update-css.ts
+function update_css_slicedToArray(r, e) { return update_css_arrayWithHoles(r) || update_css_iterableToArrayLimit(r, e) || update_css_unsupportedIterableToArray(r, e) || update_css_nonIterableRest(); }
+function update_css_nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function update_css_unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return update_css_arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? update_css_arrayLikeToArray(r, a) : void 0; } }
+function update_css_arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function update_css_iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function update_css_arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+/**
+ * Load a CSS customization of a project.
+ *
+ * This function create a new HTML Style Element and add it to the current document.
+ * Also activate the customization adding the first theme name to the body of the document.
+ *
+ * @group Utils
+ * @param data The CSS customization data.
+ */
+function loadCustomization(data) {
+  var style = document.createElement("style");
+  style.textContent = "";
+  for (var _i = 0, _Object$entries = Object.entries(data); _i < _Object$entries.length; _i++) {
+    var _Object$entries$_i = update_css_slicedToArray(_Object$entries[_i], 2),
+      themeName = _Object$entries$_i[0],
+      themeData = _Object$entries$_i[1];
+    var cssClass = loadTheme(themeName, themeData);
+    style.textContent += cssClass;
+  }
+  document.head.appendChild(style);
+  var firstThemeName = Object.keys(data).at(0);
+  if (firstThemeName != null) {
+    document.body.classList.add(firstThemeName);
+  }
+}
+
+/**
+ * Process a theme.
+ *
+ * @group Utils
+ * @param themeName The name of the Theme.
+ * @param themeData The data of the Theme.
+ * @returns A string with the processed theme to use on a CSS file.
+ */
+function loadTheme(themeName, themeData) {
+  var cssClass = ".".concat(themeName, " {\n");
+  var definitions = themeData.definitions;
+  if (definitions != null) {
+    cssClass = loadDefinitions(definitions, cssClass);
+  }
+  for (var _i2 = 0, _Object$entries2 = Object.entries((_themeData$screens = themeData.screens) !== null && _themeData$screens !== void 0 ? _themeData$screens : {}); _i2 < _Object$entries2.length; _i2++) {
+    var _themeData$screens;
+    var _Object$entries2$_i = update_css_slicedToArray(_Object$entries2[_i2], 2),
+      screenName = _Object$entries2$_i[0],
+      screenData = _Object$entries2$_i[1];
+    for (var _i3 = 0, _Object$entries3 = Object.entries(screenData); _i3 < _Object$entries3.length; _i3++) {
+      var _Object$entries3$_i = update_css_slicedToArray(_Object$entries3[_i3], 2),
+        componentName = _Object$entries3$_i[0],
+        componentData = _Object$entries3$_i[1];
+      for (var _i4 = 0, _Object$entries4 = Object.entries(componentData); _i4 < _Object$entries4.length; _i4++) {
+        var _Object$entries4$_i = update_css_slicedToArray(_Object$entries4[_i4], 2),
+          elementName = _Object$entries4$_i[0],
+          elementData = _Object$entries4$_i[1];
+        for (var _i5 = 0, _Object$entries5 = Object.entries(elementData); _i5 < _Object$entries5.length; _i5++) {
+          var _Object$entries5$_i = update_css_slicedToArray(_Object$entries5[_i5], 2),
+            propertyName = _Object$entries5$_i[0],
+            propertyValue = _Object$entries5$_i[1];
+          cssClass += "  --".concat(screenName, "-").concat(componentName, "-").concat(elementName, "-").concat(propertyName, ": ").concat(propertyValue, ";\n");
+        }
+      }
+    }
+  }
+  cssClass += "}\n";
+  return cssClass;
+}
+/**
+ * Process the definitions of a theme.
+ *
+ * @group Utils
+ * @param definitions The definitions of the theme.
+ * @param cssClass The string object that will contain the processed theme
+ * @returns The cssClass string mutated with the processed definitions.
+ */
+function loadDefinitions(definitions, cssClass) {
+  for (var _i6 = 0, _Object$entries6 = Object.entries((_definitions$colors = definitions.colors) !== null && _definitions$colors !== void 0 ? _definitions$colors : {}); _i6 < _Object$entries6.length; _i6++) {
+    var _definitions$colors;
+    var _Object$entries6$_i = update_css_slicedToArray(_Object$entries6[_i6], 2),
+      colorName = _Object$entries6$_i[0],
+      colorData = _Object$entries6$_i[1];
+    for (var _i7 = 0, _Object$entries7 = Object.entries(colorData); _i7 < _Object$entries7.length; _i7++) {
+      var _Object$entries7$_i = update_css_slicedToArray(_Object$entries7[_i7], 2),
+        colorIntensity = _Object$entries7$_i[0],
+        colorValue = _Object$entries7$_i[1];
+      cssClass += "  --definitions-colors-".concat(colorName, "-").concat(colorIntensity, ": ").concat(colorValue, ";\n");
+    }
+  }
+  for (var _i8 = 0, _Object$entries8 = Object.entries((_definitions$shadows = definitions.shadows) !== null && _definitions$shadows !== void 0 ? _definitions$shadows : {}); _i8 < _Object$entries8.length; _i8++) {
+    var _definitions$shadows;
+    var _Object$entries8$_i = update_css_slicedToArray(_Object$entries8[_i8], 2),
+      shadowName = _Object$entries8$_i[0],
+      shadowValue = _Object$entries8$_i[1];
+    cssClass += "  --definitions-shadows-".concat(shadowName, ": ").concat(shadowValue, ";\n");
+  }
+  for (var _i9 = 0, _Object$entries9 = Object.entries((_definitions$textFont = definitions.textFonts) !== null && _definitions$textFont !== void 0 ? _definitions$textFont : {}); _i9 < _Object$entries9.length; _i9++) {
+    var _definitions$textFont;
+    var _Object$entries9$_i = update_css_slicedToArray(_Object$entries9[_i9], 2),
+      fontName = _Object$entries9$_i[0],
+      fontValue = _Object$entries9$_i[1];
+    cssClass += "  --definitions-textFonts-".concat(fontName, ": ").concat(fontValue, ";\n");
+  }
+  return cssClass;
+}
 ;// ./src/index.ts
 // ─── Domain Ports (interfaces) ───────────────────────────────────────────────
 
@@ -17248,6 +18381,8 @@ function normalizeOrigin(raw) {
 
 // ─── Domain Models: Categories ───────────────────────────────────────────────
 
+// ─── Domain Models: Circle ───────────────────────────────────────────────────
+
 
 // ─── Domain Models: City Filter ──────────────────────────────────────────────