@mapvx/web-js 1.1.1 → 1.2.0

package/dist/cjs/domain/models/circle.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.circleRing = exports.resolveCircleConfig = exports.isValidCircleConfig = exports.CIRCLE_DEFAULTS = exports.MAPVX_BRAND_COLOR = void 0;
+const utils_1 = require("../../utils/utils");
+/**
+ * MapVX brand color used as the default for circle styling and other
+ * SDK-drawn overlays (colored places, borders).
+ *
+ * @group Circles
+ */
+exports.MAPVX_BRAND_COLOR = "#276EF1";
+/**
+ * Default styling values applied to a circle when the corresponding
+ * {@link CircleConfig} fields are omitted.
+ *
+ * @group Circles
+ */
+exports.CIRCLE_DEFAULTS = {
+    fillColor: exports.MAPVX_BRAND_COLOR,
+    fillOpacity: 0.14,
+    strokeColor: exports.MAPVX_BRAND_COLOR,
+    strokeWidth: 2,
+    strokeOpacity: 0.65,
+};
+/**
+ * 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: ${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 || 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=${coord.lat}, lng=${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 || typeof config !== "object") {
+        return false;
+    }
+    const c = config;
+    if (typeof c.coordinate !== "object" || c.coordinate === null)
+        return false;
+    const 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;
+    return true;
+}
+exports.isValidCircleConfig = isValidCircleConfig;
+/**
+ * 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, hidden = false) {
+    var _a, _b, _c, _d;
+    validateRadiusMeters(config.radiusMeters);
+    validateCoordinate(config.coordinate);
+    return {
+        id: (_a = config.id) !== null && _a !== void 0 ? _a : (0, utils_1.generateHexadecimalKey)(),
+        coordinate: config.coordinate,
+        radiusMeters: config.radiusMeters,
+        fillColor: (_b = config.fillColor) !== null && _b !== void 0 ? _b : exports.CIRCLE_DEFAULTS.fillColor,
+        fillOpacity: clampOpacity(config.fillOpacity, exports.CIRCLE_DEFAULTS.fillOpacity),
+        strokeColor: (_c = config.strokeColor) !== null && _c !== void 0 ? _c : exports.CIRCLE_DEFAULTS.strokeColor,
+        strokeWidth: (_d = config.strokeWidth) !== null && _d !== void 0 ? _d : exports.CIRCLE_DEFAULTS.strokeWidth,
+        strokeOpacity: clampOpacity(config.strokeOpacity, exports.CIRCLE_DEFAULTS.strokeOpacity),
+        floorId: config.floorId,
+        hidden,
+    };
+}
+exports.resolveCircleConfig = resolveCircleConfig;
+/**
+ * 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, points = 64) {
+    // A linear ring needs at least 3 distinct positions to be valid GeoJSON
+    const segments = Number.isFinite(points) ? Math.max(3, Math.floor(points)) : 64;
+    const ring = [];
+    const latRad = (lat * Math.PI) / 180;
+    const metersPerDegLat = 110574;
+    const metersPerDegLng = 111320 * Math.cos(latRad || 0.000001);
+    const latR = radiusMeters / metersPerDegLat;
+    const lngR = radiusMeters / (metersPerDegLng || 1);
+    for (let i = 0; i < segments; i += 1) {
+        const 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;
+}
+exports.circleRing = circleRing;
+//# sourceMappingURL=circle.js.map

package/dist/cjs/domain/models/circle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circle.js","sourceRoot":"","sources":["../../../../src/domain/models/circle.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadStyles = exports.MAPVX_DEFAULT_PRECONNECT_HOSTS = exports.injectPreconnects = exports.isMapVxRequestHostname = exports.OpeningHoursHelper = exports.loadCustomization = exports.MVXTransport = exports.UnitSystem = exports.TransportationMode = exports.AnnounceFormat = exports.MVXRouteStep = exports.MVXRouteLeg = exports.MVXRoute = exports.MVXPlace = exports.TextPosition = exports.Institution = exports.isBasicWithLogo = exports.isBasicWithIcon = exports.Banner = exports.createRouteAnimationIconDataUrl = exports.initializeSDK = exports.CountlyLogger = exports.FetchHttpClient = exports.DEFAULT_MAX_STORAGE_BYTES = exports.DEFAULT_CACHE_CONFIGS = exports.CacheManager = exports.PersistentCache = exports.LRUCache = void 0;
+exports.loadStyles = exports.MAPVX_DEFAULT_PRECONNECT_HOSTS = exports.injectPreconnects = exports.isMapVxRequestHostname = exports.OpeningHoursHelper = exports.loadCustomization = exports.MVXTransport = exports.UnitSystem = exports.TransportationMode = exports.AnnounceFormat = exports.MVXRouteStep = exports.MVXRouteLeg = exports.MVXRoute = exports.MVXPlace = exports.TextPosition = exports.Institution = exports.isValidCircleConfig = exports.MAPVX_BRAND_COLOR = exports.CIRCLE_DEFAULTS = exports.circleRing = exports.isBasicWithLogo = exports.isBasicWithIcon = exports.Banner = exports.createRouteAnimationIconDataUrl = exports.initializeSDK = exports.CountlyLogger = exports.FetchHttpClient = exports.DEFAULT_MAX_STORAGE_BYTES = exports.DEFAULT_CACHE_CONFIGS = exports.CacheManager = exports.PersistentCache = exports.LRUCache = void 0;
 // ─── Infrastructure: Cache ───────────────────────────────────────────────────
 var LRUCache_1 = require("./infrastructure/cache/LRUCache");
 Object.defineProperty(exports, "LRUCache", { enumerable: true, get: function () { return LRUCache_1.LRUCache; } });
@@ -30,6 +30,12 @@ Object.defineProperty(exports, "Banner", { enumerable: true, get: function () {
 var categories_1 = require("./domain/models/categories");
 Object.defineProperty(exports, "isBasicWithIcon", { enumerable: true, get: function () { return categories_1.isBasicWithIcon; } });
 Object.defineProperty(exports, "isBasicWithLogo", { enumerable: true, get: function () { return categories_1.isBasicWithLogo; } });
+// ─── Domain Models: Circle ───────────────────────────────────────────────────
+var circle_1 = require("./domain/models/circle");
+Object.defineProperty(exports, "circleRing", { enumerable: true, get: function () { return circle_1.circleRing; } });
+Object.defineProperty(exports, "CIRCLE_DEFAULTS", { enumerable: true, get: function () { return circle_1.CIRCLE_DEFAULTS; } });
+Object.defineProperty(exports, "MAPVX_BRAND_COLOR", { enumerable: true, get: function () { return circle_1.MAPVX_BRAND_COLOR; } });
+Object.defineProperty(exports, "isValidCircleConfig", { enumerable: true, get: function () { return circle_1.isValidCircleConfig; } });
 // ─── Domain Models: Institution ──────────────────────────────────────────────
 var institution_1 = require("./domain/models/institution");
 Object.defineProperty(exports, "Institution", { enumerable: true, get: function () { return institution_1.Institution; } });

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAKA,gFAAgF;AAChF,4DAA0D;AAAjD,oGAAA,QAAQ,OAAA;AACjB,0EAAwE;AAA/D,kHAAA,eAAe,OAAA;AACxB,oEAAkE;AAAzD,4GAAA,YAAY,OAAA;AAErB,kEAG2C;AAFzC,oHAAA,qBAAqB,OAAA;AACrB,wHAAA,yBAAyB,OAAA;AAG3B,gFAAgF;AAChF,yEAAuE;AAA9D,kHAAA,eAAe,OAAA;AAExB,gFAAgF;AAChF,wEAAsE;AAA7D,8GAAA,aAAa,OAAA;AAKtB,gFAAgF;AAChF,6BAAqC;AAA5B,oGAAA,aAAa,OAAA;AAatB,gFAAgF;AAChF,wCAAgE;AAAvD,wHAAA,+BAA+B,OAAA;AAGxC,gFAAgF;AAChF,iDAA+C;AAAtC,gGAAA,MAAM,OAAA;AAEf,gFAAgF;AAChF,yDAA6E;AAApE,6GAAA,eAAe,OAAA;AAAE,6GAAA,eAAe,OAAA;AAgDzC,gFAAgF;AAChF,2DAAyD;AAAhD,0GAAA,WAAW,OAAA;AAYpB,gFAAgF;AAChF,iDAAqD;AAA5C,sGAAA,YAAY,OAAA;AASrB,gFAAgF;AAChF,+CAAgD;AAAvC,iGAAA,QAAQ,OAAA;AAKjB,gFAAgF;AAChF,+CAA2E;AAAlE,iGAAA,QAAQ,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,qGAAA,YAAY,OAAA;AAE5C,gFAAgF;AAChF,yEAAmG;AAA1F,oHAAA,cAAc,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAAE,gHAAA,UAAU,OAAA;AAWvD,gFAAgF;AAChF,uDAAwD;AAA/C,yGAAA,YAAY,OAAA;AAQrB,gFAAgF;AAChF,iDAAsD;AAA7C,+GAAA,iBAAiB,OAAA;AAC1B,qEAAiE;AAAxD,0HAAA,kBAAkB,OAAA;AAC3B,uDAA8D;AAArD,uHAAA,sBAAsB,OAAA;AAC/B,iDAAsF;AAA7E,+GAAA,iBAAiB,OAAA;AAAE,4HAAA,8BAA8B,OAAA;AAE1D;;;GAGG;AACI,MAAM,UAAU,GAAG,GAAS,EAAE;IACnC,qCAAqC;IACrC,IAAI,QAAQ,CAAC,aAAa,CAAC,yBAAyB,CAAC,EAAE;QACrD,OAAM;KACP;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3C,IAAI,CAAC,GAAG,GAAG,YAAY,CAAA;IACvB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA,CAAC,wBAAwB;IACnD,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAA;IAC9C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC,CAAA;AAXY,QAAA,UAAU,cAWtB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAKA,gFAAgF;AAChF,4DAA0D;AAAjD,oGAAA,QAAQ,OAAA;AACjB,0EAAwE;AAA/D,kHAAA,eAAe,OAAA;AACxB,oEAAkE;AAAzD,4GAAA,YAAY,OAAA;AAErB,kEAG2C;AAFzC,oHAAA,qBAAqB,OAAA;AACrB,wHAAA,yBAAyB,OAAA;AAG3B,gFAAgF;AAChF,yEAAuE;AAA9D,kHAAA,eAAe,OAAA;AAExB,gFAAgF;AAChF,wEAAsE;AAA7D,8GAAA,aAAa,OAAA;AAKtB,gFAAgF;AAChF,6BAAqC;AAA5B,oGAAA,aAAa,OAAA;AAatB,gFAAgF;AAChF,wCAAgE;AAAvD,wHAAA,+BAA+B,OAAA;AAGxC,gFAAgF;AAChF,iDAA+C;AAAtC,gGAAA,MAAM,OAAA;AAEf,gFAAgF;AAChF,yDAA6E;AAApE,6GAAA,eAAe,OAAA;AAAE,6GAAA,eAAe,OAAA;AAezC,gFAAgF;AAChF,iDAK+B;AAJ7B,oGAAA,UAAU,OAAA;AACV,yGAAA,eAAe,OAAA;AACf,2GAAA,iBAAiB,OAAA;AACjB,6GAAA,mBAAmB,OAAA;AAqCrB,gFAAgF;AAChF,2DAAyD;AAAhD,0GAAA,WAAW,OAAA;AAYpB,gFAAgF;AAChF,iDAAqD;AAA5C,sGAAA,YAAY,OAAA;AASrB,gFAAgF;AAChF,+CAAgD;AAAvC,iGAAA,QAAQ,OAAA;AAKjB,gFAAgF;AAChF,+CAA2E;AAAlE,iGAAA,QAAQ,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,qGAAA,YAAY,OAAA;AAE5C,gFAAgF;AAChF,yEAAmG;AAA1F,oHAAA,cAAc,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAAE,gHAAA,UAAU,OAAA;AAWvD,gFAAgF;AAChF,uDAAwD;AAA/C,yGAAA,YAAY,OAAA;AAQrB,gFAAgF;AAChF,iDAAsD;AAA7C,+GAAA,iBAAiB,OAAA;AAC1B,qEAAiE;AAAxD,0HAAA,kBAAkB,OAAA;AAC3B,uDAA8D;AAArD,uHAAA,sBAAsB,OAAA;AAC/B,iDAAsF;AAA7E,+GAAA,iBAAiB,OAAA;AAAE,4HAAA,8BAA8B,OAAA;AAE1D;;;GAGG;AACI,MAAM,UAAU,GAAG,GAAS,EAAE;IACnC,qCAAqC;IACrC,IAAI,QAAQ,CAAC,aAAa,CAAC,yBAAyB,CAAC,EAAE;QACrD,OAAM;KACP;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3C,IAAI,CAAC,GAAG,GAAG,YAAY,CAAA;IACvB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA,CAAC,wBAAwB;IACnD,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAA;IAC9C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC,CAAA;AAXY,QAAA,UAAU,cAWtB"}

package/dist/cjs/logger/logger.js

@@ -17,7 +17,7 @@ const countly = {
 // The typeof guards make the lookup safe everywhere; the version placeholder
 // is replaced with the package version by scripts/inject-build-defines.js.
 const IS_DEBUG = typeof DEBUG !== "undefined" ? DEBUG : false;
-const SDK_VERSION = typeof VERSION !== "undefined" ? VERSION : "1.1.1";
+const SDK_VERSION = typeof VERSION !== "undefined" ? VERSION : "1.2.0";
 class Logger {
     constructor() {
         var _a;

package/dist/cjs/logger/rollbar.js

@@ -5,7 +5,7 @@ exports.argsToDict = exports._rollbarConfig = void 0;
 // 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.
-const SDK_VERSION = typeof VERSION !== "undefined" ? VERSION : "1.1.1";
+const SDK_VERSION = typeof VERSION !== "undefined" ? VERSION : "1.2.0";
 exports._rollbarConfig = {
     accessToken: "28279d52df43411ebd138c2bee0ab1df",
     // Only report what the SDK logs explicitly via logError. Capturing every

package/dist/cjs/map/map.js

@@ -25,6 +25,12 @@ var __importStar = (this && this.__importStar) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InternalMapVXMap = void 0;
 const maplibre_gl_1 = __importStar(require("maplibre-gl"));
+/** Shared GeoJSON source holding every circle drawn through the circle API. */
+const CIRCLE_SOURCE_ID = "mapvx-circles";
+/** Fill layer rendering the translucent interior of the circles. */
+const CIRCLE_FILL_LAYER_ID = "mapvx-circles-fill";
+/** Line layer rendering the circle outlines. */
+const CIRCLE_LINE_LAYER_ID = "mapvx-circles-line";
 // Flag to track if cached-tile protocol has been registered
 let cachedTileProtocolRegistered = false;
 /**
@@ -119,6 +125,7 @@ const _rtl_1 = require("../domain/models/_rtl");
 const animation_1 = require("../domain/models/animation");
 const loggeable_1 = require("../domain/models/loggeable");
 const mapConfig_1 = require("../domain/models/mapConfig");
+const circle_1 = require("../domain/models/circle");
 const marker_1 = require("../domain/models/marker");
 const route_1 = require("../domain/models/route");
 const routeConfiguration_1 = require("../domain/models/routeConfiguration");
@@ -148,6 +155,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
         this.currentFloor = "";
         this.baseFilters = {};
         this.markers = [];
+        this.circles = [];
         this.enableHover = false;
         this.hoveredId = "unselected";
         this.failedTiles = new Set();
@@ -305,6 +313,12 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
             this.onHover();
             this.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", () => {
+            if (this.circles.length > 0)
+                this.ensureCircleLayers();
+        });
         this.map.on("zoomend", () => {
             var _a;
             (_a = mapConfig.onZoomEnd) === null || _a === void 0 ? void 0 : _a.call(mapConfig, this.getZoomLevel());
@@ -423,6 +437,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
         return Object.assign(Object.assign({}, segmentation), { token: this.token, parentPlaceId: (_a = this.parentPlaceId) !== null && _a !== void 0 ? _a : "None" });
     }
     destroyMap() {
+        this.circles = [];
         this.map.remove();
         this.unsubscribeFromFailedTiles();
     }
@@ -526,6 +541,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
             this.setBaseFilters(newStyle);
         }
         this.routeController.addSourcesAndLayers();
+        this.refreshCircles();
         this.filterByFloorKey(this.currentFloor);
     }
     addMarker(marker) {
@@ -631,6 +647,260 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
             throw new Error("Failed to remove all markers");
         }
     }
+    addCircle(circle) {
+        try {
+            // Check if a circle with the same ID already exists and replace it
+            if (circle.id) {
+                this.circles = this.circles.filter((c) => c.id !== circle.id);
+            }
+            // resolveCircleConfig validates radiusMeters and coordinates
+            const record = (0, circle_1.resolveCircleConfig)(circle);
+            this.circles.push(record);
+            this.refreshCircles();
+            this.logEvent("addCircle");
+            return record.id;
+        }
+        catch (error) {
+            throw new Error(`Failed to add circle: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    updateCircle(circleConfig) {
+        try {
+            const index = this.circles.findIndex((c) => c.id === circleConfig.id);
+            if (index === -1)
+                return null;
+            // resolveCircleConfig validates radiusMeters and coordinates
+            this.circles[index] = (0, circle_1.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: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    getCircle(circleId) {
+        return this.circles.find((c) => c.id === circleId);
+    }
+    getCircles() {
+        return this.circles.slice();
+    }
+    hasCircle(circleId) {
+        return this.circles.some((c) => c.id === circleId);
+    }
+    updateCirclePosition(circleId, center, radiusMeters) {
+        try {
+            const circle = this.circles.find((c) => c.id === circleId);
+            if (circle === undefined)
+                return false;
+            // Validate inputs before modifying
+            if (!center) {
+                throw new Error("Circle center is required");
+            }
+            const { lat, lng } = center;
+            if (!Number.isFinite(lat) || lat < -90 || lat > 90) {
+                throw new Error(`Invalid latitude: ${lat}. Must be between -90 and 90.`);
+            }
+            if (!Number.isFinite(lng) || lng < -180 || lng > 180) {
+                throw new Error(`Invalid longitude: ${lng}. Must be between -180 and 180.`);
+            }
+            if (radiusMeters !== undefined) {
+                if (!Number.isFinite(radiusMeters) || radiusMeters <= 0) {
+                    throw new Error(`Invalid radiusMeters: ${radiusMeters}. Must be a positive finite number.`);
+                }
+            }
+            circle.coordinate = center;
+            if (radiusMeters !== undefined) {
+                circle.radiusMeters = radiusMeters;
+            }
+            this.refreshCircles();
+            this.logEvent("updateCirclePosition");
+            return true;
+        }
+        catch (error) {
+            throw new Error(`Failed to update circle position: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    updateCircleStyle(circleId, style) {
+        try {
+            const circle = this.circles.find((c) => c.id === circleId);
+            if (circle === undefined)
+                return false;
+            // Update only style properties, clamp opacities
+            if (style.fillColor !== undefined)
+                circle.fillColor = style.fillColor;
+            if (style.fillOpacity !== undefined)
+                circle.fillOpacity = Math.max(0, Math.min(1, style.fillOpacity));
+            if (style.strokeColor !== undefined)
+                circle.strokeColor = style.strokeColor;
+            if (style.strokeWidth !== undefined)
+                circle.strokeWidth = style.strokeWidth;
+            if (style.strokeOpacity !== undefined)
+                circle.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: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    removeCircle(circleId) {
+        try {
+            this.circles = this.circles.filter((c) => c.id !== circleId);
+            this.refreshCircles();
+            this.logEvent("removeCircle");
+        }
+        catch (error) {
+            throw new Error("Failed to remove circle");
+        }
+    }
+    removeAllCircles() {
+        try {
+            this.circles = [];
+            this.refreshCircles();
+            this.logEvent("removeAllCircles");
+        }
+        catch (error) {
+            throw new Error("Failed to remove all circles");
+        }
+    }
+    showCircle(circleId) {
+        try {
+            const circle = this.circles.find((c) => c.id === circleId);
+            if (circle === undefined) {
+                return false;
+            }
+            circle.hidden = false;
+            this.refreshCircles();
+            this.logEvent("showCircle");
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    hideCircle(circleId) {
+        try {
+            const circle = this.circles.find((c) => c.id === circleId);
+            if (circle === undefined) {
+                return false;
+            }
+            circle.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.
+     */
+    circleFeatureCollection() {
+        var _a, _b, _c;
+        const floorId = (_a = this.currentFloor) !== null && _a !== void 0 ? _a : "";
+        const isOutdoor = !this.parentPlace ||
+            ((_c = (_b = this.innerFloors.find((floor) => floor.key === floorId)) === null || _b === void 0 ? void 0 : _b.reachableFromGPS) !== null && _c !== void 0 ? _c : false);
+        const features = this.circles
+            .filter((circle) => {
+            var _a;
+            if (circle.hidden)
+                return false;
+            const circleFloor = (_a = circle.floorId) !== null && _a !== void 0 ? _a : "";
+            return circleFloor === floorId || (isOutdoor && circleFloor === "");
+        })
+            .map((circle) => ({
+            type: "Feature",
+            properties: {
+                id: circle.id,
+                fillColor: circle.fillColor,
+                fillOpacity: circle.fillOpacity,
+                strokeColor: circle.strokeColor,
+                strokeWidth: circle.strokeWidth,
+                strokeOpacity: circle.strokeOpacity,
+            },
+            geometry: {
+                type: "Polygon",
+                coordinates: [
+                    (0, circle_1.circleRing)(circle.coordinate.lng, circle.coordinate.lat, circle.radiusMeters),
+                ],
+            },
+        }));
+        return { type: "FeatureCollection", 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.
+     */
+    ensureCircleLayers() {
+        var _a, _b, _c;
+        if (!this.map)
+            return;
+        try {
+            if (!this.map.getSource(CIRCLE_SOURCE_ID)) {
+                this.map.addSource(CIRCLE_SOURCE_ID, {
+                    type: "geojson",
+                    data: this.circleFeatureCollection(),
+                });
+            }
+            const beforeId = (_c = (_b = (_a = this.map.getStyle()) === null || _a === void 0 ? void 0 : _a.layers) === null || _b === void 0 ? void 0 : _b.find((layer) => layer.type === "symbol")) === null || _c === void 0 ? void 0 : _c.id;
+            if (!this.map.getLayer(CIRCLE_FILL_LAYER_ID)) {
+                const fillLayer = {
+                    id: CIRCLE_FILL_LAYER_ID,
+                    type: "fill",
+                    source: CIRCLE_SOURCE_ID,
+                    paint: {
+                        "fill-color": ["get", "fillColor"],
+                        "fill-opacity": ["get", "fillOpacity"],
+                    },
+                };
+                this.map.addLayer(fillLayer, beforeId);
+            }
+            if (!this.map.getLayer(CIRCLE_LINE_LAYER_ID)) {
+                const lineLayer = {
+                    id: CIRCLE_LINE_LAYER_ID,
+                    type: "line",
+                    source: CIRCLE_SOURCE_ID,
+                    paint: {
+                        "line-color": ["get", "strokeColor"],
+                        "line-width": ["get", "strokeWidth"],
+                        "line-opacity": ["get", "strokeOpacity"],
+                    },
+                };
+                this.map.addLayer(lineLayer, beforeId);
+            }
+        }
+        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.
+     */
+    refreshCircles() {
+        if (!this.map)
+            return;
+        if (this.circles.length === 0 && !this.map.getSource(CIRCLE_SOURCE_ID))
+            return;
+        this.ensureCircleLayers();
+        try {
+            const source = this.map.getSource(CIRCLE_SOURCE_ID);
+            source === null || source === void 0 ? 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
      * @param floorKey floor id
@@ -643,6 +913,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
         }
         this.updateFiltersTo(floorKeyString);
         this.updateMarkersTo(floorKeyString);
+        this.refreshCircles();
         this.routeController.updateRouteLayers(floorKeyString);
         this.routeController.updateRouteMarkerVisibility(floorKeyString);
     }
@@ -1045,7 +1316,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
                 filter: ["all", ["has", "ref"], ["==", ["get", "ref"], "unselected"]],
                 paint: {
                     "fill-extrusion-height": 2.5,
-                    "fill-extrusion-color": "#276EF1",
+                    "fill-extrusion-color": circle_1.MAPVX_BRAND_COLOR,
                     "fill-extrusion-opacity": 0.8,
                 },
             };
@@ -1059,7 +1330,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
                 "source-layer": "area",
                 filter: ["all", ["has", "ref"], ["==", ["get", "ref"], "unselected"]],
                 paint: {
-                    "fill-color": "#276EF1",
+                    "fill-color": circle_1.MAPVX_BRAND_COLOR,
                 },
             };
             this.map.addLayer(layer);
@@ -1317,7 +1588,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
             "source-layer": "area",
             filter: ["all", ["has", "ref"], ["==", ["get", "ref"], "unselected"]],
             paint: {
-                "line-color": "#276EF1",
+                "line-color": circle_1.MAPVX_BRAND_COLOR,
                 "line-width": 4,
             },
         };