@mapvx/web-js 3.1.0-dev.2 → 3.1.0

package/dist/cjs/controllers/markerLayoutController.js

@@ -1,337 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MarkerLayoutController = exports.FALLBACK_ORDER = exports.ANCHOR_FRACTIONS = void 0;
-exports.computeIconRect = computeIconRect;
-exports.computeCandidateRect = computeCandidateRect;
-exports.expandRect = expandRect;
-exports.rectsIntersect = rectsIntersect;
-const marker_1 = require("../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.
- */
-exports.ANCHOR_FRACTIONS = {
-    center: { fx: 0.5, fy: 0.5 },
-    top: { fx: 0.5, fy: 0 },
-    bottom: { fx: 0.5, fy: 1 },
-    left: { fx: 0, fy: 0.5 },
-    right: { fx: 1, fy: 0.5 },
-    "top-left": { fx: 0, fy: 0 },
-    "top-right": { fx: 1, fy: 0 },
-    "bottom-left": { fx: 0, fy: 1 },
-    "bottom-right": { fx: 1, fy: 1 },
-};
-/** Candidate order tried when a marker's preferred side is unavailable. */
-exports.FALLBACK_ORDER = [
-    marker_1.TextPosition.right,
-    marker_1.TextPosition.top,
-    marker_1.TextPosition.left,
-    marker_1.TextPosition.bottom,
-];
-/** Builds the icon's on-screen rect from its projected point, size and anchor. */
-function computeIconRect(screen, iconSize, anchor) {
-    var _a;
-    const { fx, fy } = (_a = exports.ANCHOR_FRACTIONS[anchor]) !== null && _a !== void 0 ? _a : exports.ANCHOR_FRACTIONS.center;
-    return {
-        left: screen.x - fx * iconSize.width,
-        top: screen.y - fy * iconSize.height,
-        width: iconSize.width,
-        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.
- */
-function computeCandidateRect(iconRect, labelSize, position, gapPx, verticalGapPx) {
-    switch (position) {
-        case marker_1.TextPosition.left:
-            return {
-                left: iconRect.left - gapPx - labelSize.width,
-                top: iconRect.top + iconRect.height / 2 - labelSize.height / 2,
-                width: labelSize.width,
-                height: labelSize.height,
-            };
-        case marker_1.TextPosition.top:
-            return {
-                left: iconRect.left + iconRect.width / 2 - labelSize.width / 2,
-                top: iconRect.top - verticalGapPx - labelSize.height,
-                width: labelSize.width,
-                height: labelSize.height,
-            };
-        case marker_1.TextPosition.bottom:
-            return {
-                left: iconRect.left + iconRect.width / 2 - labelSize.width / 2,
-                top: iconRect.top + iconRect.height + verticalGapPx,
-                width: labelSize.width,
-                height: labelSize.height,
-            };
-        case marker_1.TextPosition.right:
-        default:
-            return {
-                left: iconRect.left + iconRect.width + gapPx,
-                top: iconRect.top + iconRect.height / 2 - labelSize.height / 2,
-                width: labelSize.width,
-                height: labelSize.height,
-            };
-    }
-}
-/** Expands a rect by `padding` on every side. */
-function expandRect(rect, padding) {
-    return {
-        left: rect.left - padding,
-        top: rect.top - padding,
-        width: rect.width + 2 * padding,
-        height: rect.height + 2 * padding,
-    };
-}
-/** Standard AABB intersection test. */
-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. See {@link MarkerLayoutConfig}.
- *
- * Not part of the public SDK surface — owned and driven entirely by
- * {@link InternalMapVXMap}, mirroring `RouteController`.
- */
-class MarkerLayoutController {
-    constructor(map, config) {
-        this.labelSizeCache = new WeakMap();
-        this.iconSizeCache = new WeakMap();
-        this.lastAppliedState = new WeakMap();
-        this.attached = false;
-        this.mapvxMap = map;
-        this.config = config;
-        this.boundOnMove = () => this.scheduleRelayout();
-    }
-    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;
-        this.attached = true;
-        this.map.on("move", this.boundOnMove);
-        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)
-            return;
-        fonts.ready
-            .then(() => {
-            if (!this.attached)
-                return;
-            this.labelSizeCache = new WeakMap();
-            this.iconSizeCache = new WeakMap();
-            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);
-            this.attached = false;
-        }
-        if (this.rafHandle !== undefined) {
-            cancelAnimationFrame(this.rafHandle);
-            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;
-        this.rafHandle = requestAnimationFrame(() => {
-            this.rafHandle = undefined;
-            this.performLayout();
-        });
-    }
-    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();
-        if (markers.length === 0)
-            return;
-        const container = this.map.getContainer();
-        const viewportWidth = container.clientWidth;
-        const viewportHeight = container.clientHeight;
-        const cullMargin = this.config.maxLabelWidthPx + Math.max(this.config.gapPx, this.config.verticalGapPx);
-        const entries = this.readMarkers(markers, viewportWidth, viewportHeight, cullMargin);
-        const decisions = this.decidePlacements(entries);
-        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) {
-            if (!marker.getElement().isConnected)
-                continue;
-            const screen = this.map.project(marker.getLngLat());
-            const iconRect = computeIconRect(screen, this.resolveIconSize(marker), marker.anchorType);
-            const outOfViewport = iconRect.left + iconRect.width < -cullMargin ||
-                iconRect.left > viewportWidth + cullMargin ||
-                iconRect.top + iconRect.height < -cullMargin ||
-                iconRect.top > viewportHeight + cullMargin;
-            if (outOfViewport)
-                continue;
-            entries.push({ marker, iconRect, labelSize: this.resolveLabelSize(marker) });
-        }
-        return entries;
-    }
-    resolveLabelSize(marker) {
-        const textEl = marker.textContainerEl;
-        if (!textEl)
-            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)
-            return cached;
-        const measured = { width: element.offsetWidth, height: element.offsetHeight };
-        if (measured.width <= 0 || measured.height <= 0)
-            return undefined;
-        cache.set(marker, measured);
-        return measured;
-    }
-    /** Compute phase: pure, no DOM access. Icons always block; labels negotiate a side or hide. */
-    decidePlacements(entries) {
-        const placedLabels = [];
-        const withLabel = entries.filter(hasLabelSize);
-        // Stable sort (spec-guaranteed): equal priority keeps insertion order.
-        withLabel.sort((a, b) => b.marker.labelPriority - a.marker.labelPriority);
-        const decisions = new Map();
-        for (const entry of withLabel) {
-            const order = [
-                entry.marker.preferredTextPosition,
-                ...exports.FALLBACK_ORDER.filter((position) => position !== entry.marker.preferredTextPosition),
-            ];
-            const fit = order
-                .map((position) => ({
-                position,
-                rect: computeCandidateRect(entry.iconRect, entry.labelSize, position, this.config.gapPx, this.config.verticalGapPx),
-            }))
-                .find(({ rect }) => !this.collides(rect, entry.marker, entries, placedLabels));
-            if (fit) {
-                placedLabels.push(fit.rect);
-                decisions.set(entry.marker, { position: fit.position, hidden: false });
-            }
-            else {
-                decisions.set(entry.marker, { position: entry.marker.preferredTextPosition, hidden: true });
-            }
-        }
-        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);
-            if (last && last.position === decision.position && last.hidden === decision.hidden)
-                return;
-            if (marker.textContainerEl) {
-                marker_1.MarkerUtils.applyTextPosition(marker.textContainerEl, decision.position, decision.hidden);
-            }
-            this.lastAppliedState.set(marker, decision);
-        });
-    }
-}
-exports.MarkerLayoutController = MarkerLayoutController;
-function hasLabelSize(entry) {
-    return entry.labelSize !== undefined;
-}
-//# sourceMappingURL=markerLayoutController.js.map

package/dist/cjs/controllers/markerLayoutController.js.map

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

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

@@ -1,140 +0,0 @@
-import { type PositionAnchor } from "maplibre-gl";
-import { type MarkerLayoutConfig } from "../domain/models/mapConfig";
-import { type MarkerAttribute, TextPosition } from "../domain/models/marker";
-import { type InternalMapVXMap } from "../map/map";
-/** Axis-aligned box in screen (CSS pixel) space. */
-export interface Rect {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-}
-/**
- * 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 declare const ANCHOR_FRACTIONS: Record<PositionAnchor, {
-    fx: number;
-    fy: number;
-}>;
-/** Candidate order tried when a marker's preferred side is unavailable. */
-export declare const FALLBACK_ORDER: TextPosition[];
-/** Builds the icon's on-screen rect from its projected point, size and anchor. */
-export declare function computeIconRect(screen: {
-    x: number;
-    y: number;
-}, iconSize: {
-    width: number;
-    height: number;
-}, anchor: PositionAnchor): Rect;
-/**
- * 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 declare function computeCandidateRect(iconRect: Rect, labelSize: {
-    width: number;
-    height: number;
-}, position: TextPosition, gapPx: number, verticalGapPx: number): Rect;
-/** Expands a rect by `padding` on every side. */
-export declare function expandRect(rect: Rect, padding: number): Rect;
-/** Standard AABB intersection test. */
-export declare function rectsIntersect(a: Rect, b: Rect): boolean;
-/**
- * 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. See {@link MarkerLayoutConfig}.
- *
- * Not part of the public SDK surface — owned and driven entirely by
- * {@link InternalMapVXMap}, mirroring `RouteController`.
- */
-export declare class MarkerLayoutController {
-    private readonly mapvxMap;
-    private readonly config;
-    private labelSizeCache;
-    private iconSizeCache;
-    private readonly lastAppliedState;
-    private readonly boundOnMove;
-    private rafHandle;
-    private attached;
-    constructor(map: InternalMapVXMap, config: Required<MarkerLayoutConfig>);
-    private get 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(): void;
-    /**
-     * 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: HTMLElement): void;
-    /**
-     * 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.
-     */
-    private remeasureWhenFontsLoad;
-    /** Stops listening and cancels any pending layout pass. */
-    destroy(): void;
-    /**
-     * 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: MarkerAttribute): void;
-    /** Coalesces repeated calls into a single layout pass per animation frame. */
-    scheduleRelayout(): void;
-    private performLayout;
-    /** Read phase: project + measure, no writes. Culls markers fully outside the viewport. */
-    private readMarkers;
-    private resolveLabelSize;
-    /**
-     * 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.
-     */
-    private resolveIconSize;
-    /**
-     * 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.
-     */
-    private measureCached;
-    /** Compute phase: pure, no DOM access. Icons always block; labels negotiate a side or hide. */
-    private decidePlacements;
-    /**
-     * 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.
-     */
-    private collides;
-    /** Write phase: only touches the DOM for markers whose decision actually changed. */
-    private applyDecisions;
-}
-//# sourceMappingURL=markerLayoutController.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"markerLayoutController.d.ts","sourceRoot":"","sources":["../../../src/controllers/markerLayoutController.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAC1E,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAE,KAAK,eAAe,EAAe,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACzF,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,oDAAoD;AACpD,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAOD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAU/E,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,cAAc,EAAE,YAAY,EAKxC,CAAA;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAChC,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC3C,MAAM,EAAE,cAAc,GACrB,IAAI,CAQN;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,IAAI,EACd,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5C,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,IAAI,CAgCN;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAO5D;AAED,uCAAuC;AACvC,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,OAAO,CAOxD;AAED;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,cAAc,CAAoE;IAC1F,OAAO,CAAC,aAAa,CAAoE;IACzF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgD;IACjF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAY;IACxC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC;IAMvE,OAAO,KAAK,GAAG,GAEd;IAED;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAQd;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IAMlD;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAgB9B,2DAA2D;IAC3D,OAAO,IAAI,IAAI;IAWf;;;;;;;;;OASG;IACH,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAM/C,8EAA8E;IAC9E,gBAAgB,IAAI,IAAI;IAQxB,OAAO,CAAC,aAAa;IAoBrB,0FAA0F;IAC1F,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,gBAAgB;IAMxB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAKvB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAcrB,+FAA+F;IAC/F,OAAO,CAAC,gBAAgB;IAoCxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,QAAQ;IAahB,qFAAqF;IACrF,OAAO,CAAC,cAAc;CAWvB"}