@minmaps-dev/mm-web-sdk 1.0.0-rc.30 → 1.0.0-rc.32

package/dist/index.d.ts

@@ -142,6 +142,10 @@ interface Waypoint {
     floorId?: string | number;
     /** Whether this is the primary/default waypoint */
     isPrimary?: boolean;
+    /** CMS zone (department) this waypoint belongs to, if any. The only backend
+     *  link between a location and its department — read at runtime across the
+     *  data provider (see the package CLAUDE.md zone landmine). */
+    zoneId?: string | number;
 }
 /**
  * Amenity enriched with the floor it belongs to
@@ -161,6 +165,23 @@ interface POISearchResult {
     matchedFields: string[];
 }
 
+/**
+ * A Zone is a CMS-authored department category — a named, colored grouping
+ * (e.g. "Cardiology", "Surgical", "Admin"). Zones are venue-wide (not
+ * floor-scoped) in the JACS `/all` payload and carry no geometry of their own;
+ * their spatial footprint is derived from the waypoints that reference them
+ * (`waypoint.zoneId`), which lets the SDK color-code the room/unit polygons a
+ * zone covers. See `map/zones.ts` for the derivation.
+ */
+interface Zone {
+    id: number;
+    name: string;
+    /** Authored hex color (e.g. "#d32f2f"); may be empty when the author
+     *  hasn't picked one — such zones are skipped for color-coding. */
+    color: string;
+    description?: string;
+}
+
 /** Captured camera state (center, zoom, pitch, bearing) */
 type CameraState = {
     center: [number, number];
@@ -260,6 +281,10 @@ type ArriveStep = StepBase & {
 interface MapEvent {
     floor?: Floor;
     poi?: POI;
+    /** All POIs co-located at a clicked point (overlapping pins / a shared
+     *  suite). Emitted by `poiSelected`; length ≥ 1, and `poi` mirrors
+     *  `pois[0]` for single-POI consumers. */
+    pois?: POI[];
     coordinates?: [number, number];
     error?: any;
     venue?: any;
@@ -354,6 +379,12 @@ interface SDKOptions {
     enableInteractions?: boolean;
     customSprite?: string;
     minIndoorZoom?: number;
+    /**
+     * Interior unit-wall thickness in feet (default 1). Each wall is built by
+     * insetting a ring into each unit by `wallThickness / 2`, so adjacent units
+     * share a wall (their rings abut at the common edge). Floored at 0.5 — a
+     * thinner value collapses the negative buffer and drops the wall.
+     */
     wallThickness?: number;
     boundsPadding?: BoundsPadding;
     /**
@@ -526,7 +557,42 @@ declare class MinuteMaps {
     private amenityManager;
     private wayfinding;
     private highlightManager;
+    private selectionManager;
+    /** Captured unit paint values to restore when the selection clears, or
+     *  `null` when no room is currently focused. See `UNIT_DIM_TARGETS`. */
+    private unitDimRestore;
+    /** Captured destination-layer filters to restore when the selection clears,
+     *  or `null` when no destination focus is active. See `setDestinationFocus`. */
+    private destFocusRestore;
     private youAreHerePulse;
+    /** Theme layers whose features represent a tappable destination/amenity.
+     *  A click hit-tests these (see `SelectionManager`) → `poiSelected`. The
+     *  "You are here" anchor and the transient highlight layers are excluded;
+     *  a POI drawn across the circle/label/icon layers is de-duped downstream
+     *  in `resolveClickedPOIs`. */
+    private static readonly CLICKABLE_POI_LAYERS;
+    /** Room-body layers that are also tappable: a click on a `Units` polygon
+     *  resolves to the destination pin inside it (see `resolvePOIsFromFeatures`).
+     *  Queried alongside the pin layers so tapping the room or its dot behaves
+     *  identically. Kept separate from the pin list because these carry no POI
+     *  identity of their own — they resolve spatially. */
+    private static readonly CLICKABLE_UNIT_LAYERS;
+    /** While a room is selected, the other units are recolored to a flat, muted
+     *  gray so the raised, full-strength highlight block reads as the focus. We
+     *  recolor rather than lower opacity on purpose: translucent extrusions blend
+     *  through their neighbours and look murky. The blocks stay fully opaque (and
+     *  keep their vertical-gradient shading, so they still read as rooms) — just
+     *  colorless. The selected room's own base grays too, but its highlight cap
+     *  sits opaque and taller on top, so it still stands out. The original paint
+     *  value (the data-driven color expression) is captured at mute time and put
+     *  back on `clearHighlight`, so department tinting returns intact. */
+    private static readonly UNIT_DIM_TARGETS;
+    /** Destination marker layers hidden down to just the selected destination
+     *  while a room is focused, so the map declutters to the one place in view.
+     *  Amenity/connector layers (`poiType: 'amenity'`), the "you are here" anchor,
+     *  and room name labels (`map-labels`) are deliberately absent — they stay
+     *  visible as wayfinding reference. Restored on `clearHighlight`. */
+    private static readonly DESTINATION_FOCUS_LAYERS;
     /** Categorical POI layers in the bundled theme that `setPOIFilter`
      *  toggles. Layers absent from this list — `poi-you-are-here-*`, the
      *  `poi-accessibility-icons` badge, and the `poi-highlight-*` layers —
@@ -618,6 +684,31 @@ declare class MinuteMaps {
     getCurrentFloor(): Floor | null;
     getDefaultFloor(): Floor | null;
     getDestinations(floor?: Floor): Destination[];
+    getZones(): Zone[];
+    /** The department (zone) a POI belongs to, resolved via its waypoint's
+     *  `zoneId` — the only backend link between a location and a department
+     *  (see the zone landmine in the package CLAUDE.md). `null` when the POI
+     *  has no waypoint, no zone, or the zone id is unknown. */
+    getZoneForPOI(poi: POI): Zone | null;
+    /** Human-readable detail fields for a POI info popover. Only surfaces
+     *  fields that exist on the current data — `category`, `floorName`,
+     *  `zoneName`, `keywords`, and `description` are each omitted when absent.
+     *  Keeps the display-field derivation (incl. the zone lookup) in the SDK
+     *  so consumers stay thin. */
+    getPOIDetails(poi: POI): {
+        name: string;
+        type: 'amenity' | 'destination' | 'kiosk';
+        category?: string;
+        floorName?: string;
+        zoneName?: string;
+        zoneDescription?: string;
+        keywords?: string[];
+        description?: string;
+    };
+    /** Resolve the source Destination/Amenity record backing a rendered POI,
+     *  for detail fields (category, localized description) that don't live on
+     *  the built POI object. */
+    private getSourceEntity;
     getPolygonLayers(): any[];
     getFloorMapTemplate3d(floorId: string | number): any[];
     getAllPOIs(floor?: Floor): POI[];
@@ -753,8 +844,52 @@ declare class MinuteMaps {
      * it lives on another one. Pass a POI / amenity / destination id.
      */
     highlightPOI(id: string | number): Promise<void>;
-    /** Remove the POI highlight set by `highlightPOI`. */
+    /** Remove the POI highlight set by `highlightPOI`, un-dim the other units,
+     *  and bring back the destination markers hidden by a room selection. */
     clearHighlight(): void;
+    /** Map a click's raw feature hits to the full, de-duplicated POIs at that
+     *  point (see `resolvePOIsFromFeatures`). Injected into `SelectionManager`.
+     *  `getAllPOIs()` is the current floor's rendered POIs — the only clickable
+     *  ones — and carries each POI's `waypoint`, needed for directions. */
+    private resolveClickedPOIs;
+    /** Emit `poiSelected` for the co-located POIs at a clicked point. Focuses the
+     *  selection in place (no recenter — the user already sees where they
+     *  tapped): rings the tapped dot and, when the tap landed in a room, raises
+     *  that room as a highlighted block so the eye goes to the selected unit.
+     *  `clearHighlight` removes both. `poi` mirrors `pois[0]` for single-POI
+     *  consumers. */
+    private emitPoiSelected;
+    /**
+     * Build the room-highlight payload for a selection. The colour comes from the
+     * *clicked* feature (the rendered truth), but the geometry comes from the
+     * floor's full source polygon — the clicked feature is from
+     * `queryRenderedFeatures`, whose geometry is clipped to on-screen tiles, so
+     * highlighting it directly would leave any off-screen part of the room grey
+     * (its base extrusion is muted). Falls back to the clipped geometry if the
+     * full polygon can't be found. Returns `null` for a pin with no room.
+     */
+    private unitHighlightFor;
+    /** The full, unclipped `Units` polygon on the current floor that contains
+     *  `coord`, straight from the floor source (not the tile-clipped render). */
+    private fullUnitPolygonAt;
+    /**
+     * Hide every destination marker except the given ids (pass `null` to
+     * restore all). Narrows each destination layer's own filter with an id
+     * allow-list; amenity/connector/"you are here" layers are untouched, so they
+     * stay on the map as reference. Captures the original filters once and puts
+     * them back verbatim, so the layers' base rules (poiType, showLabel, iconId)
+     * survive.
+     */
+    private setDestinationFocus;
+    /** Gentle pan so the selection sits in the centre of the map area MapLibre
+     *  frames within `boundsPadding` (which the consumer sets to reserve for its
+     *  bottom-docked chrome / info card). A straight `easeTo`, current zoom kept,
+     *  so it reads as a nudge, not a recenter. */
+    private easeToSelection;
+    /** Dim every unit's paint (or restore it) so a selected room reads as the
+     *  focus. Idempotent: capturing only happens on the first activate, and the
+     *  captured originals are put back verbatim on deactivate. */
+    private setUnitFocusDim;
     /**
      * Show only the named POI categories on the map. Pass `['amenity']` to
      * emphasize amenities (e.g. while an Amenities drawer is open) — destination
@@ -901,4 +1036,4 @@ declare function groupStepsIntoFloorSections(steps: WayfindStep[]): RouteFloorSe
 declare function activeSectionIndex(sections: RouteFloorSection[], activeStepIndex: number): number;
 
 export { MinuteMaps, activeSectionIndex, createMinuteMapsSDK, groupStepsIntoFloorSections };
-export type { Amenity, AmenityBadgeStyle, AmenityWithFloor, Bounds, BoundsPadding, CameraState, Destination, DestinationChipStyle, EventCallback, Floor, FloorMetadata, JMapAuth, JMapConfig, JacsAuth, JacsConfig, MapEvent, POI, POISearchResult, RouteFloorSection, RoutePoint, RoutingOptions, SDKConfig, SDKOptions, ThemeName, TransitionStep, ViewOptions, WayfindCenterMode, WayfindStep, Waypoint };
+export type { Amenity, AmenityBadgeStyle, AmenityWithFloor, Bounds, BoundsPadding, CameraState, Destination, DestinationChipStyle, EventCallback, Floor, FloorMetadata, JMapAuth, JMapConfig, JacsAuth, JacsConfig, MapEvent, POI, POISearchResult, RouteFloorSection, RoutePoint, RoutingOptions, SDKConfig, SDKOptions, ThemeName, TransitionStep, ViewOptions, WayfindCenterMode, WayfindStep, Waypoint, Zone };