@mapvx/web-js 1.1.0 → 1.1.1

package/dist/es/logger/rollbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"rollbar.js","sourceRoot":"","sources":["../../../src/logger/rollbar.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,WAAW,EAAE,kCAAkC;IAC/C,eAAe,EAAE,IAAI;IACrB,0BAA0B,EAAE,IAAI;IAChC,OAAO,EAAE;QACP,WAAW,EAAE,SAAS;QACtB,0BAA0B;QAC1B,MAAM,EAAE;YACN,UAAU,EAAE;gBACV,YAAY,EAAE,KAAK;gBACnB,4BAA4B;gBAC5B,8BAA8B;aAC/B;SACF;KACF;CACF,CAAA;AAED,MAAM,UAAU,UAAU,CACxB,GAAG,IAAmB;IAEtB,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;AAC/D,CAAC"}
+{"version":3,"file":"rollbar.js","sourceRoot":"","sources":["../../../src/logger/rollbar.ts"],"names":[],"mappings":"AAIA,0EAA0E;AAC1E,wEAAwE;AACxE,4EAA4E;AAC5E,wEAAwE;AACxE,MAAM,WAAW,GAAW,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAA;AAExF,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,WAAW,EAAE,kCAAkC;IAC/C,yEAAyE;IACzE,uEAAuE;IACvE,uEAAuE;IACvE,6BAA6B;IAC7B,eAAe,EAAE,KAAK;IACtB,0BAA0B,EAAE,KAAK;IACjC,wDAAwD;IACxD,WAAW,EAAE,OAAO;IACpB,OAAO,EAAE;QACP,WAAW,EAAE,YAAY;QACzB,MAAM,EAAE;YACN,UAAU,EAAE;gBACV,YAAY,EAAE,WAAW;aAC1B;SACF;KACF;CACF,CAAA;AAED,MAAM,UAAU,UAAU,CAAC,GAAG,IAAmB;IAC/C,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;AAC/D,CAAC"}

package/dist/es/utils/preconnect.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Hostnames that MapVX maps typically need to talk to during the first
+ * paint: vector tiles, sprite, glyphs and indoor tile sources. Exposed so
+ * that consumer apps can call `injectPreconnects(MAPVX_DEFAULT_PRECONNECT_HOSTS)`
+ * without having to maintain the list themselves.
+ *
+ * @group Utils
+ */
+export declare const MAPVX_DEFAULT_PRECONNECT_HOSTS: readonly string[];
+/**
+ * Injects `<link rel="preconnect">` (and a `<link rel="dns-prefetch">` fallback)
+ * tags into `document.head` for the given origins, so the browser starts the
+ * DNS + TLS handshake before MapLibre actually requests sprite/glyph/tile
+ * resources.
+ *
+ * Call this as early as possible — ideally before {@link initializeSDK} — to
+ * maximize the savings. In real captures this shaves ~150-300 ms off the
+ * first-paint cascade.
+ *
+ * Idempotent: hosts that already have a `<link rel="preconnect" crossorigin>`
+ * are skipped. If an existing `preconnect` link is missing `crossorigin`, it
+ * is upgraded in place (added `crossorigin="anonymous"`) — without that
+ * attribute the warmed socket can't be reused for the CORS tile/font/sprite
+ * fetches MapLibre performs, so leaving the existing link untouched would
+ * silently defeat the optimization. Existing `crossorigin="use-credentials"`
+ * is respected and never overwritten.
+ *
+ * @param hosts - Origin URLs (`"https://tiles.mapvx.com"`) or bare hostnames
+ *   (`"tiles.mapvx.com"`, normalized to `https://`). Invalid entries are
+ *   silently ignored.
+ * @returns The origins where the helper made a change — either a new link was
+ *   appended, or an existing one was upgraded with `crossorigin="anonymous"`.
+ *
+ * @example
+ * ```ts
+ * import { initializeSDK, injectPreconnects, MAPVX_DEFAULT_PRECONNECT_HOSTS } from "@mapvx/web-js"
+ *
+ * injectPreconnects(MAPVX_DEFAULT_PRECONNECT_HOSTS)
+ * const sdk = initializeSDK(apiKey)
+ * ```
+ *
+ * @group Utils
+ */
+export declare function injectPreconnects(hosts: readonly string[]): string[];
+//# sourceMappingURL=preconnect.d.ts.map

package/dist/es/utils/preconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preconnect.d.ts","sourceRoot":"","sources":["../../../src/utils/preconnect.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAI3D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CA+CpE"}

package/dist/es/utils/preconnect.js

@@ -0,0 +1,127 @@
+/**
+ * Hostnames that MapVX maps typically need to talk to during the first
+ * paint: vector tiles, sprite, glyphs and indoor tile sources. Exposed so
+ * that consumer apps can call `injectPreconnects(MAPVX_DEFAULT_PRECONNECT_HOSTS)`
+ * without having to maintain the list themselves.
+ *
+ * @group Utils
+ */
+export const MAPVX_DEFAULT_PRECONNECT_HOSTS = [
+    "https://tiles.mapvx.com",
+    "https://api.maptiler.com",
+    "https://indoorequals.mapvx.com",
+];
+/**
+ * Injects `<link rel="preconnect">` (and a `<link rel="dns-prefetch">` fallback)
+ * tags into `document.head` for the given origins, so the browser starts the
+ * DNS + TLS handshake before MapLibre actually requests sprite/glyph/tile
+ * resources.
+ *
+ * Call this as early as possible — ideally before {@link initializeSDK} — to
+ * maximize the savings. In real captures this shaves ~150-300 ms off the
+ * first-paint cascade.
+ *
+ * Idempotent: hosts that already have a `<link rel="preconnect" crossorigin>`
+ * are skipped. If an existing `preconnect` link is missing `crossorigin`, it
+ * is upgraded in place (added `crossorigin="anonymous"`) — without that
+ * attribute the warmed socket can't be reused for the CORS tile/font/sprite
+ * fetches MapLibre performs, so leaving the existing link untouched would
+ * silently defeat the optimization. Existing `crossorigin="use-credentials"`
+ * is respected and never overwritten.
+ *
+ * @param hosts - Origin URLs (`"https://tiles.mapvx.com"`) or bare hostnames
+ *   (`"tiles.mapvx.com"`, normalized to `https://`). Invalid entries are
+ *   silently ignored.
+ * @returns The origins where the helper made a change — either a new link was
+ *   appended, or an existing one was upgraded with `crossorigin="anonymous"`.
+ *
+ * @example
+ * ```ts
+ * import { initializeSDK, injectPreconnects, MAPVX_DEFAULT_PRECONNECT_HOSTS } from "@mapvx/web-js"
+ *
+ * injectPreconnects(MAPVX_DEFAULT_PRECONNECT_HOSTS)
+ * const sdk = initializeSDK(apiKey)
+ * ```
+ *
+ * @group Utils
+ */
+export function injectPreconnects(hosts) {
+    if (typeof document === "undefined" || !document.head)
+        return [];
+    if (!Array.isArray(hosts) || hosts.length === 0)
+        return [];
+    const injected = [];
+    for (const raw of hosts) {
+        if (typeof raw !== "string" || raw.length === 0)
+            continue;
+        const origin = normalizeOrigin(raw);
+        if (origin === null)
+            continue;
+        // Check what's already in <head>. We may need to UPGRADE an existing
+        // preconnect — server-rendered or hand-authored hints frequently omit
+        // `crossorigin`, and a warmed socket without it cannot be reused for
+        // the CORS tile/font/sprite fetches that MapLibre performs. Without
+        // this branch the optimization would silently no-op when the page
+        // already had a partial hint.
+        const existingPreconnect = findLinkForOrigin("preconnect", origin);
+        let preconnectChanged = false;
+        if (existingPreconnect) {
+            if (!existingPreconnect.hasAttribute("crossorigin")) {
+                existingPreconnect.crossOrigin = "anonymous";
+                preconnectChanged = true;
+            }
+            // If the existing link already has any `crossorigin` value
+            // (including `use-credentials`), respect the author's intent and
+            // leave it alone.
+        }
+        else {
+            const preconnect = document.createElement("link");
+            preconnect.rel = "preconnect";
+            preconnect.href = origin;
+            preconnect.crossOrigin = "anonymous";
+            document.head.appendChild(preconnect);
+            preconnectChanged = true;
+        }
+        // dns-prefetch is a fallback for older browsers that ignore preconnect.
+        if (!findLinkForOrigin("dns-prefetch", origin)) {
+            const dnsPrefetch = document.createElement("link");
+            dnsPrefetch.rel = "dns-prefetch";
+            dnsPrefetch.href = origin;
+            document.head.appendChild(dnsPrefetch);
+        }
+        if (preconnectChanged)
+            injected.push(origin);
+    }
+    return injected;
+}
+/**
+ * Returns the first `<link rel="${rel}">` in `<head>` whose resolved origin
+ * matches `origin`, or null. We compare canonical URL origins instead of
+ * the raw `href` attribute text — the same origin can be written as
+ * `https://tiles.mapvx.com` or `https://tiles.mapvx.com/`, and a strict
+ * attribute selector would miss the second form and inject a duplicate.
+ */
+function findLinkForOrigin(rel, origin) {
+    const links = document.head.querySelectorAll(`link[rel="${rel}"]`);
+    for (let i = 0; i < links.length; i++) {
+        const link = links[i];
+        try {
+            if (new URL(link.href).origin === origin)
+                return link;
+        }
+        catch (_a) {
+            // Malformed href — skip and keep scanning.
+        }
+    }
+    return null;
+}
+function normalizeOrigin(raw) {
+    try {
+        const candidate = /^https?:\/\//i.test(raw) ? raw : `https://${raw}`;
+        return new URL(candidate).origin;
+    }
+    catch (_a) {
+        return null;
+    }
+}
+//# sourceMappingURL=preconnect.js.map

package/dist/es/utils/preconnect.js.map

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

package/dist/umd/index.js

@@ -5728,6 +5728,7 @@ __webpack_require__.d(__webpack_exports__, {
   FetchHttpClient: () => (/* reexport */ FetchHttpClient),
   Institution: () => (/* reexport */ Institution),
   LRUCache: () => (/* reexport */ LRUCache),
+  MAPVX_DEFAULT_PRECONNECT_HOSTS: () => (/* reexport */ MAPVX_DEFAULT_PRECONNECT_HOSTS),
   MVXPlace: () => (/* reexport */ place_MVXPlace),
   MVXRoute: () => (/* reexport */ MVXRoute),
   MVXRouteLeg: () => (/* reexport */ MVXRouteLeg),
@@ -5740,6 +5741,7 @@ __webpack_require__.d(__webpack_exports__, {
   UnitSystem: () => (/* reexport */ UnitSystem),
   createRouteAnimationIconDataUrl: () => (/* reexport */ createRouteAnimationIconDataUrl),
   initializeSDK: () => (/* reexport */ initializeSDK),
+  injectPreconnects: () => (/* reexport */ injectPreconnects),
   isBasicWithIcon: () => (/* reexport */ isBasicWithIcon),
   isBasicWithLogo: () => (/* reexport */ isBasicWithLogo),
   isMapVxRequestHostname: () => (/* reexport */ isMapVxRequestHostname),
@@ -6784,18 +6786,26 @@ 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;
 var _rollbarConfig = {
-  accessToken: "1e7e62a3edc14868b4098d653d0f33b9",
-  captureUncaught: true,
-  captureUnhandledRejections: true,
+  accessToken: "28279d52df43411ebd138c2bee0ab1df",
+  // 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)
+  // that the SDK does not own.
+  captureUncaught: false,
+  captureUnhandledRejections: false,
+  // Drop anything below error level (debug/info/warning).
+  reportLevel: "error",
   payload: {
-    environment: "testenv",
-    // context: 'rollbar/test'
+    environment: "production",
     client: {
       javascript: {
-        code_version: "1.0"
-        // source_map_enabled: true,
-        // guess_uncaught_frames: true
+        code_version: SDK_VERSION
       }
     }
   }
@@ -6822,19 +6832,30 @@ var logger_countly = {
   apiKey: "f0c8d3b96d336e857a8628f49dd1baf7d7add0e9",
   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);
-    if (false) // removed by dead control flow
-{} else {
+    if (IS_DEBUG) {
+      console.log("Initializing Countly");
+      this.countly = {
+        q: []
+      };
+    } else {
       var _Countly$q;
       this.rollbar = new (rollbar_umd_min_default())(_rollbarConfig);
       countly_default().init({
         app_key: logger_countly.apiKey,
         url: logger_countly.url,
-        app_version: "1.1.0",
+        app_version: logger_SDK_VERSION,
         session_update: 10,
-        debug: false,
+        debug: IS_DEBUG,
         require_consent: false,
         namespace: "SDK JS"
       });
@@ -6846,8 +6867,9 @@ var Logger = /*#__PURE__*/function () {
   return logger_createClass(Logger, [{
     key: "logEvent",
     value: function logEvent(eventName, eventSegmentation) {
-      if (false) // removed by dead control flow
-{} else {
+      if (IS_DEBUG) {
+        console.log(eventName, eventSegmentation);
+      } else {
         this.countly.q.push(["add_event", {
           key: eventName,
           segmentation: eventSegmentation
@@ -6857,14 +6879,18 @@ var Logger = /*#__PURE__*/function () {
   }, {
     key: "logDebug",
     value: function logDebug() {
-      if (false) // removed by dead control flow
-{ var _console; }
+      if (IS_DEBUG) {
+        var _console;
+        (_console = console).log.apply(_console, arguments);
+      }
     }
   }, {
     key: "logWarning",
     value: function logWarning() {
-      if (false) // removed by dead control flow
-{ var _console2; }
+      if (IS_DEBUG) {
+        var _console2;
+        (_console2 = console).warn.apply(_console2, arguments);
+      }
     }
   }, {
     key: "logError",
@@ -6872,8 +6898,10 @@ var Logger = /*#__PURE__*/function () {
       for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
         args[_key] = arguments[_key];
       }
-      if (false) // removed by dead control flow
-{ var _console3; } else {
+      if (IS_DEBUG) {
+        var _console3;
+        (_console3 = console).error.apply(_console3, args);
+      } else {
         var _this$rollbar;
         (_this$rollbar = this.rollbar) === null || _this$rollbar === void 0 || _this$rollbar.error.apply(_this$rollbar, args);
       }
@@ -6882,8 +6910,7 @@ var Logger = /*#__PURE__*/function () {
     key: "debugLog",
     value: function debugLog() {
       var _console4;
-      if (false) // removed by dead control flow
-{}
+      if (IS_DEBUG) (_console4 = console).log.apply(_console4, arguments);
     }
   }], [{
     key: "getInstance",
@@ -7569,6 +7596,9 @@ var MarkerAttribute = /*#__PURE__*/function (_Marker) {
     _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");
+    if (typeof markerConfig.rotation === "number") {
+      _this.setRotation(markerConfig.rotation);
+    }
     _this.id = (_markerConfig$id = markerConfig.id) !== null && _markerConfig$id !== void 0 ? _markerConfig$id : generateHexadecimalKey();
     _this.coordinate = markerConfig.coordinate;
     _this.floorId = (_markerConfig$floorId = markerConfig.floorId) !== null && _markerConfig$floorId !== void 0 ? _markerConfig$floorId : "";
@@ -7625,6 +7655,9 @@ var MarkerAttribute = /*#__PURE__*/function (_Marker) {
       }
       this.setRotationAlignment((_marker$rotationAlign = marker.rotationAlignment) !== null && _marker$rotationAlign !== void 0 ? _marker$rotationAlign : "viewport");
       this.setPitchAlignment("viewport");
+      if (typeof marker.rotation === "number") {
+        this.setRotation(marker.rotation);
+      }
     }
 
     /**
@@ -17054,6 +17087,136 @@ function is24Hours(openingTime) {
   // Check if open is "00:00" and close is "24:00" or "00:00"
   return open === "00:00" && close === "24:00" || open === "00:00" && close === "00:00";
 }
+;// ./src/utils/preconnect.ts
+function preconnect_createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = preconnect_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 preconnect_unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return preconnect_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) ? preconnect_arrayLikeToArray(r, a) : void 0; } }
+function preconnect_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; }
+/**
+ * Hostnames that MapVX maps typically need to talk to during the first
+ * paint: vector tiles, sprite, glyphs and indoor tile sources. Exposed so
+ * that consumer apps can call `injectPreconnects(MAPVX_DEFAULT_PRECONNECT_HOSTS)`
+ * without having to maintain the list themselves.
+ *
+ * @group Utils
+ */
+var MAPVX_DEFAULT_PRECONNECT_HOSTS = ["https://tiles.mapvx.com", "https://api.maptiler.com", "https://indoorequals.mapvx.com"];
+
+/**
+ * Injects `<link rel="preconnect">` (and a `<link rel="dns-prefetch">` fallback)
+ * tags into `document.head` for the given origins, so the browser starts the
+ * DNS + TLS handshake before MapLibre actually requests sprite/glyph/tile
+ * resources.
+ *
+ * Call this as early as possible — ideally before {@link initializeSDK} — to
+ * maximize the savings. In real captures this shaves ~150-300 ms off the
+ * first-paint cascade.
+ *
+ * Idempotent: hosts that already have a `<link rel="preconnect" crossorigin>`
+ * are skipped. If an existing `preconnect` link is missing `crossorigin`, it
+ * is upgraded in place (added `crossorigin="anonymous"`) — without that
+ * attribute the warmed socket can't be reused for the CORS tile/font/sprite
+ * fetches MapLibre performs, so leaving the existing link untouched would
+ * silently defeat the optimization. Existing `crossorigin="use-credentials"`
+ * is respected and never overwritten.
+ *
+ * @param hosts - Origin URLs (`"https://tiles.mapvx.com"`) or bare hostnames
+ *   (`"tiles.mapvx.com"`, normalized to `https://`). Invalid entries are
+ *   silently ignored.
+ * @returns The origins where the helper made a change — either a new link was
+ *   appended, or an existing one was upgraded with `crossorigin="anonymous"`.
+ *
+ * @example
+ * ```ts
+ * import { initializeSDK, injectPreconnects, MAPVX_DEFAULT_PRECONNECT_HOSTS } from "@mapvx/web-js"
+ *
+ * injectPreconnects(MAPVX_DEFAULT_PRECONNECT_HOSTS)
+ * const sdk = initializeSDK(apiKey)
+ * ```
+ *
+ * @group Utils
+ */
+function injectPreconnects(hosts) {
+  if (typeof document === "undefined" || !document.head) return [];
+  if (!Array.isArray(hosts) || hosts.length === 0) return [];
+  var injected = [];
+  var _iterator = preconnect_createForOfIteratorHelper(hosts),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var raw = _step.value;
+      if (typeof raw !== "string" || raw.length === 0) continue;
+      var origin = normalizeOrigin(raw);
+      if (origin === null) continue;
+
+      // Check what's already in <head>. We may need to UPGRADE an existing
+      // preconnect — server-rendered or hand-authored hints frequently omit
+      // `crossorigin`, and a warmed socket without it cannot be reused for
+      // the CORS tile/font/sprite fetches that MapLibre performs. Without
+      // this branch the optimization would silently no-op when the page
+      // already had a partial hint.
+      var existingPreconnect = findLinkForOrigin("preconnect", origin);
+      var preconnectChanged = false;
+      if (existingPreconnect) {
+        if (!existingPreconnect.hasAttribute("crossorigin")) {
+          existingPreconnect.crossOrigin = "anonymous";
+          preconnectChanged = true;
+        }
+        // If the existing link already has any `crossorigin` value
+        // (including `use-credentials`), respect the author's intent and
+        // leave it alone.
+      } else {
+        var preconnect = document.createElement("link");
+        preconnect.rel = "preconnect";
+        preconnect.href = origin;
+        preconnect.crossOrigin = "anonymous";
+        document.head.appendChild(preconnect);
+        preconnectChanged = true;
+      }
+
+      // dns-prefetch is a fallback for older browsers that ignore preconnect.
+      if (!findLinkForOrigin("dns-prefetch", origin)) {
+        var dnsPrefetch = document.createElement("link");
+        dnsPrefetch.rel = "dns-prefetch";
+        dnsPrefetch.href = origin;
+        document.head.appendChild(dnsPrefetch);
+      }
+      if (preconnectChanged) injected.push(origin);
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return injected;
+}
+
+/**
+ * Returns the first `<link rel="${rel}">` in `<head>` whose resolved origin
+ * matches `origin`, or null. We compare canonical URL origins instead of
+ * the raw `href` attribute text — the same origin can be written as
+ * `https://tiles.mapvx.com` or `https://tiles.mapvx.com/`, and a strict
+ * attribute selector would miss the second form and inject a duplicate.
+ */
+function findLinkForOrigin(rel, origin) {
+  var links = document.head.querySelectorAll("link[rel=\"".concat(rel, "\"]"));
+  for (var i = 0; i < links.length; i++) {
+    var link = links[i];
+    try {
+      if (new URL(link.href).origin === origin) return link;
+    } catch (_unused) {
+      // Malformed href — skip and keep scanning.
+    }
+  }
+  return null;
+}
+function normalizeOrigin(raw) {
+  try {
+    var candidate = /^https?:\/\//i.test(raw) ? raw : "https://".concat(raw);
+    return new URL(candidate).origin;
+  } catch (_unused2) {
+    return null;
+  }
+}
 ;// ./src/index.ts
 // ─── Domain Ports (interfaces) ───────────────────────────────────────────────
 
@@ -17135,6 +17298,7 @@ function is24Hours(openingTime) {
 
 
 
+
 /**
  * Function to load default styles
  * @group Utils