@mapvx/web-js 4.0.3-dev.1 → 4.0.3-dev.2

package/dist/es/assets/icons.d.ts

@@ -83,4 +83,3 @@ export declare function createRouteAnimationIconDataUrl(config?: RouteAnimationI
  * @group Assets
  */
 export declare const routeAnimationDataUrl: string;
-//# sourceMappingURL=icons.d.ts.map

package/dist/es/assets/icons.js

@@ -1,38 +1,4 @@
 export const 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";
-/**
- * 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: "#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).
- * @param config.borderColor - The border color of the circle (default: "#000000").
- * @param config.blur - The blur radius in pixels to apply to the icon (default: 0).
- * @returns A data URL string that can be used as the `src` attribute of an `<img>` element.
- *
- * @example
- * ```typescript
- * // Use default appearance (blue background, white arrow)
- * const defaultIcon = createRouteAnimationIconDataUrl()
- *
- * // Customize colors
- * const customIcon = createRouteAnimationIconDataUrl({
- *   backgroundColor: "#FF5733",
- *   arrowColor: "#000000"
- * })
- *
- * // Add border and blur
- * const styledIcon = createRouteAnimationIconDataUrl({
- *   backgroundColor: "#0076B6",
- *   arrowColor: "#FFFFFF",
- *   borderWidth: 2,
- *   borderColor: "#000000",
- *   blur: 1
- * })
- * ```
- * @group Assets
- */
 export function createRouteAnimationIconDataUrl(config) {
     var _a, _b, _c, _d, _e, _f;
     const backgroundColor = (_a = config === null || config === void 0 ? void 0 : config.backgroundColor) !== null && _a !== void 0 ? _a : "#276EF1";
@@ -41,13 +7,10 @@ export function createRouteAnimationIconDataUrl(config) {
     const borderWidth = (_d = config === null || config === void 0 ? void 0 : config.borderWidth) !== null && _d !== void 0 ? _d : 0;
     const borderColor = (_e = config === null || config === void 0 ? void 0 : config.borderColor) !== null && _e !== void 0 ? _e : "#000000";
     const blur = (_f = config === null || config === void 0 ? void 0 : config.blur) !== null && _f !== void 0 ? _f : 0;
-    // Build circle style with optional border
     const circleStyle = `fill:${backgroundColor};`;
     const circleStroke = borderWidth > 0 ? `stroke:${borderColor};stroke-width:${borderWidth};` : "";
-    // Build arrow style with optional stroke
     const arrowStyle = `fill:${arrowColor};`;
     const arrowStroke = arrowWidth > 0 ? `stroke:${arrowColor};stroke-width:${arrowWidth};` : "";
-    // Build filter for blur if needed
     const filterId = blur > 0 ? "blurFilter" : "";
     const filterDef = blur > 0
         ? `<defs><filter id="${filterId}"><feGaussianBlur in="SourceGraphic" stdDeviation="${blur}"/></filter></defs>`
@@ -62,20 +25,7 @@ ${filterDef}
 	<path style="${arrowStyle}${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"/>
 </g>
 </svg>`;
-    // Encode the SVG as a data URL
     const encodedSvg = encodeURIComponent(svg);
     return `data:image/svg+xml,${encodedSvg}`;
 }
-/**
- * Default route animation icon data URL with blue background (#276EF1) and white arrow (#FFFFFF).
- * This constant is maintained for backward compatibility.
- *
- * @example
- * ```typescript
- * const image = new Image(40, 40)
- * image.src = routeAnimationDataUrl
- * ```
- * @group Assets
- */
 export const routeAnimationDataUrl = createRouteAnimationIconDataUrl();
-//# sourceMappingURL=icons.js.map

package/dist/es/config/draco.d.ts

@@ -9,4 +9,3 @@
  */
 export declare const DEFAULT_DRACO_DECODER_PATH = "https://mapvx-glb-assets.s3.us-east-1.amazonaws.com/decoders/draco/";
 export declare const DEFAULT_KTX2_TRANSCODER_PATH = "https://mapvx-glb-assets.s3.us-east-1.amazonaws.com/decoders/transcoder/";
-//# sourceMappingURL=draco.d.ts.map

package/dist/es/config/draco.js

@@ -1,12 +1,2 @@
-/**
- * Base URL for Three.js Draco decoders (glTF build from `three/examples/jsm/libs/draco/gltf`).
- * Trailing slash is required by {@link https://threejs.org/docs/#examples/en/loaders/DRACOLoader | DRACOLoader}.
- *
- * Hosted files: `draco_wasm_wrapper.js`, `draco_decoder.wasm` (and optionally `draco_decoder.js`).
- * The bucket must allow CORS for application origins that load 3D maps.
- *
- * @group Configuration
- */
 export const DEFAULT_DRACO_DECODER_PATH = "https://mapvx-glb-assets.s3.us-east-1.amazonaws.com/decoders/draco/";
 export const DEFAULT_KTX2_TRANSCODER_PATH = "https://mapvx-glb-assets.s3.us-east-1.amazonaws.com/decoders/transcoder/";
-//# sourceMappingURL=draco.js.map

package/dist/es/config/sdkConfig.d.ts

@@ -160,4 +160,3 @@ export interface SDKConfig extends MapVxApiEndpoints {
      */
     mapvxRequestContext?: MapVxRequestContext;
 }
-//# sourceMappingURL=sdkConfig.d.ts.map

package/dist/es/config/sdkConfig.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=sdkConfig.js.map

package/dist/es/controllers/markerLayoutController.d.ts

@@ -145,4 +145,3 @@ export declare class MarkerLayoutController {
     /** Write phase: only touches the DOM for markers whose decision actually changed. */
     private applyDecisions;
 }
-//# sourceMappingURL=markerLayoutController.d.ts.map

package/dist/es/controllers/markerLayoutController.js

@@ -1,10 +1,4 @@
 import { MarkerUtils, TextPosition } from "../domain/models/marker";
-/**
- * Fraction of the icon's own box, along each axis, that MapLibre's Marker
- * anchor math (`translate(-x%, -y%)`) aligns to the geodetic point. Mirrors
- * MapLibre's own `anchorTranslate` table so the collision math agrees with
- * what's actually on screen.
- */
 export const ANCHOR_FRACTIONS = {
     center: { fx: 0.5, fy: 0.5 },
     top: { fx: 0.5, fy: 0 },
@@ -16,14 +10,12 @@ export const ANCHOR_FRACTIONS = {
     "bottom-left": { fx: 0, fy: 1 },
     "bottom-right": { fx: 1, fy: 1 },
 };
-/** Candidate order tried when a marker's preferred side is unavailable. */
 export const FALLBACK_ORDER = [
     TextPosition.right,
     TextPosition.top,
     TextPosition.left,
     TextPosition.bottom,
 ];
-/** Builds the icon's on-screen rect from its projected point, size and anchor. */
 export function computeIconRect(screen, iconSize, anchor) {
     var _a;
     const { fx, fy } = (_a = ANCHOR_FRACTIONS[anchor]) !== null && _a !== void 0 ? _a : ANCHOR_FRACTIONS.center;
@@ -34,11 +26,6 @@ export function computeIconRect(screen, iconSize, anchor) {
         height: iconSize.height,
     };
 }
-/**
- * Builds a candidate label rect for one side of an icon. Mirrors the CSS in
- * `styles.css` (`.text-container.right/left/top/bottom`) exactly, so a
- * position the algorithm picks as collision-free renders collision-free.
- */
 export function computeCandidateRect(iconRect, labelSize, position, gapPx, verticalGapPx) {
     switch (position) {
         case TextPosition.left:
@@ -72,7 +59,6 @@ export function computeCandidateRect(iconRect, labelSize, position, gapPx, verti
             };
     }
 }
-/** Expands a rect by `padding` on every side. */
 export function expandRect(rect, padding) {
     return {
         left: rect.left - padding,
@@ -81,23 +67,12 @@ export function expandRect(rect, padding) {
         height: rect.height + 2 * padding,
     };
 }
-/** Standard AABB intersection test. */
 export function rectsIntersect(a, b) {
     return (a.left < b.left + b.width &&
         a.left + a.width > b.left &&
         a.top < b.top + b.height &&
         a.top + a.height > b.top);
 }
-/**
- * Automatic collision avoidance for marker text labels: keeps a marker's
- * icon fixed while moving (or hiding) its label to avoid overlapping
- * neighboring markers' icons/labels, similar to Google Maps' label
- * placement. Below `minZoomForLabels` it withholds every label instead, so
- * a zoomed-out map shows pins only. See {@link MarkerLayoutConfig}.
- *
- * Not part of the public SDK surface — owned and driven entirely by
- * {@link InternalMapVXMap}, mirroring `RouteController`.
- */
 export class MarkerLayoutController {
     constructor(map, config) {
         this.labelSizeCache = new WeakMap();
@@ -111,11 +86,6 @@ export class MarkerLayoutController {
     get map() {
         return this.mapvxMap.map;
     }
-    /**
-     * Starts listening for camera movement. Safe to call once the underlying
-     * MapLibre `Map` instance exists; a single `"move"` listener covers pan,
-     * zoom, rotate, pitch and `resize()`.
-     */
     attach() {
         if (this.attached)
             return;
@@ -124,27 +94,11 @@ export class MarkerLayoutController {
         this.remeasureWhenFontsLoad();
         this.scheduleRelayout();
     }
-    /**
-     * Publishes the configured gaps and label width cap as CSS custom
-     * properties, which `styles.css` reads to offset labels from their icon.
-     * Without this the stylesheet would keep its hardcoded defaults while the
-     * collision math used the configured values, so any custom `gapPx` /
-     * `verticalGapPx` would produce placements this controller believes are
-     * collision-free but that visibly overlap on screen.
-     *
-     * Called with the map's own container, so every marker MapLibre mounts
-     * inside it inherits the values.
-     */
     applyLayoutVariables(container) {
         container.style.setProperty("--mapvx-label-gap", `${this.config.gapPx}px`);
         container.style.setProperty("--mapvx-label-vertical-gap", `${this.config.verticalGapPx}px`);
         container.style.setProperty("--mapvx-label-max-width", `${this.config.maxLabelWidthPx}px`);
     }
-    /**
-     * A label measured before its web font finishes loading is measured in the
-     * fallback font, and that wrong footprint would otherwise be cached for
-     * the marker's lifetime. Drop every measurement once fonts settle.
-     */
     remeasureWhenFontsLoad() {
         const fonts = document.fonts;
         if (!fonts)
@@ -158,11 +112,8 @@ export class MarkerLayoutController {
             this.scheduleRelayout();
         })
             .catch(() => {
-            // Font loading failing is not a layout error: the measurements
-            // already taken in the fallback font stay in effect.
         });
     }
-    /** Stops listening and cancels any pending layout pass. */
     destroy() {
         if (this.attached) {
             this.map.off("move", this.boundOnMove);
@@ -173,22 +124,11 @@ export class MarkerLayoutController {
             this.rafHandle = undefined;
         }
     }
-    /**
-     * Drops everything cached for a marker, e.g. after its text/content
-     * changed.
-     *
-     * The last applied decision has to go too: rebuilding a marker's DOM
-     * replaces its `.text-container` with a fresh one carrying the preferred
-     * side and no `visibility`, so a decision remembered from the old element
-     * would make {@link applyDecisions} short-circuit and leave the new label
-     * on the wrong side — or visible when it should be hidden.
-     */
     invalidateMarker(marker) {
         this.labelSizeCache.delete(marker);
         this.iconSizeCache.delete(marker);
         this.lastAppliedState.delete(marker);
     }
-    /** Coalesces repeated calls into a single layout pass per animation frame. */
     scheduleRelayout() {
         if (!this.config.enabled || this.rafHandle !== undefined)
             return;
@@ -198,9 +138,6 @@ export class MarkerLayoutController {
         });
     }
     performLayout() {
-        // Guards against a relayout firing before the underlying MapLibre `map`
-        // exists (e.g. a marker added before the "load" event) — `attach()`
-        // schedules its own initial pass once it's safe to touch `this.map`.
         if (!this.attached)
             return;
         const markers = this.mapvxMap.getMarkers();
@@ -210,16 +147,11 @@ export class MarkerLayoutController {
         const viewportWidth = container.clientWidth;
         const viewportHeight = container.clientHeight;
         const cullMargin = this.config.maxLabelWidthPx + Math.max(this.config.gapPx, this.config.verticalGapPx);
-        // A single `>=` per pass, evaluated here rather than in `attach()` so it
-        // tracks the live camera: the controller already relayouts on every
-        // "move", which fires continuously through a pan/pinch, so labels cross
-        // the threshold mid-gesture instead of snapping at its end.
         const labelsAllowed = this.map.getZoom() >= this.config.minZoomForLabels;
         const entries = this.readMarkers(markers, viewportWidth, viewportHeight, cullMargin);
         const decisions = this.decidePlacements(entries, labelsAllowed);
         this.applyDecisions(decisions);
     }
-    /** Read phase: project + measure, no writes. Culls markers fully outside the viewport. */
     readMarkers(markers, viewportWidth, viewportHeight, cullMargin) {
         const entries = [];
         for (const marker of markers) {
@@ -243,25 +175,12 @@ export class MarkerLayoutController {
             return undefined;
         return this.measureCached(this.labelSizeCache, marker, textEl);
     }
-    /**
-     * The icon's box. Markers built from a caller-supplied `element` with no
-     * declared `iconProperties` are measured from the DOM, since their real
-     * size is whatever that element renders at; everyone else's box is exactly
-     * what `MarkerUtils.createMarkerElement` pinned it to.
-     */
     resolveIconSize(marker) {
         var _a;
         if (!marker.measureIconFromDom)
             return marker.iconSize;
         return (_a = this.measureCached(this.iconSizeCache, marker, marker.getElement())) !== null && _a !== void 0 ? _a : marker.iconSize;
     }
-    /**
-     * Measures an element once and remembers it. A zero measurement is
-     * returned but never cached: it means the element isn't laid out yet (a
-     * `display: none` ancestor, a first pass before the web font loads), and
-     * caching it would freeze that marker's footprint at nothing for the rest
-     * of its life.
-     */
     measureCached(cache, marker, element) {
         const cached = cache.get(marker);
         if (cached)
@@ -272,14 +191,6 @@ export class MarkerLayoutController {
         cache.set(marker, measured);
         return measured;
     }
-    /**
-     * Compute phase: pure, no DOM access. Icons always block; labels negotiate
-     * a side or hide.
-     *
-     * Below `minZoomForLabels` every label is hidden and none is placed, so no
-     * label ever becomes an obstacle for a neighbor at that zoom — a label the
-     * threshold withheld must not displace anything on its way out.
-     */
     decidePlacements(entries, labelsAllowed) {
         const placedLabels = [];
         const withLabel = entries.filter(hasLabelSize);
@@ -293,7 +204,6 @@ export class MarkerLayoutController {
             }
             return decisions;
         }
-        // Stable sort (spec-guaranteed): equal priority keeps insertion order.
         withLabel.sort((a, b) => b.marker.labelPriority - a.marker.labelPriority);
         for (const entry of withLabel) {
             const order = [
@@ -316,23 +226,11 @@ export class MarkerLayoutController {
         }
         return decisions;
     }
-    /**
-     * Whether a candidate label rect clashes with any other marker's icon or
-     * with a label already placed this pass.
-     *
-     * A label's own icon is deliberately excluded: `gapPx`/`verticalGapPx`
-     * already define the spacing to it, and `paddingPx` is breathing room
-     * against *neighbors*. Counting the own icon here would make top/bottom
-     * impossible for every marker as soon as `paddingPx` exceeded
-     * `verticalGapPx` (4 vs 4 by default) — and at `paddingPx: 10` would hide
-     * every label on the map.
-     */
     collides(rect, self, entries, placedLabels) {
         const padded = expandRect(rect, this.config.paddingPx);
         return (entries.some((other) => other.marker !== self && rectsIntersect(padded, other.iconRect)) ||
             placedLabels.some((label) => rectsIntersect(padded, label)));
     }
-    /** Write phase: only touches the DOM for markers whose decision actually changed. */
     applyDecisions(decisions) {
         decisions.forEach((decision, marker) => {
             const last = this.lastAppliedState.get(marker);
@@ -348,4 +246,3 @@ export class MarkerLayoutController {
 function hasLabelSize(entry) {
     return entry.labelSize !== undefined;
 }
-//# sourceMappingURL=markerLayoutController.js.map

package/dist/es/controllers/routeController.d.ts

@@ -265,4 +265,3 @@ export declare class RouteController {
     setMarkerFloor(floorId?: string, routeId?: string): void;
     private cameraFollow;
 }
-//# sourceMappingURL=routeController.d.ts.map