@minmaps-dev/mm-web-sdk 1.0.0-rc.34 → 1.0.0-rc.36

package/dist/index.d.ts

@@ -14,6 +14,10 @@ interface Floor {
     mapId?: string | number;
     /** Display name of the floor */
     name: string;
+    /** Short display name of the floor (e.g. "L2"). Optional: JACS leaves it
+     *  unset on plenty of floors, and `JacsDataProvider` maps a blank one to
+     *  `undefined` rather than inventing a value. */
+    shortName?: string;
     /** Floor sequence/order (e.g., -1 for basement, 0 for ground, 1 for first floor) */
     sequence?: number;
     /** Associated map data */
@@ -29,6 +33,7 @@ interface Floor {
 interface FloorMetadata {
     id: string | number;
     name: string;
+    shortName?: string;
     sequence?: number;
     isDefault?: boolean;
     isActive?: boolean;
@@ -51,12 +56,17 @@ interface POI {
     floorId: string | number;
     /** Category/type of amenity (e.g., 'restroom', 'elevator') */
     amenityType?: string;
+    /** Locale-stable classification text (name + type + keywords, frozen at
+     *  load before any locale patch can translate them). Copied from the
+     *  source `Amenity.classifyText`; used by `amenityCategoryFor`/rank
+     *  instead of the live, possibly-translated fields. See `Amenity.classifyText`. */
+    classifyText?: string;
     /** Which amenity icon layer this POI renders in — `'connector'`,
-     *  `'entrance'`, `'parking'`, `'bus'` or `'other'`. Derived from the
-     *  amenity's connector flag, name, type and keywords; emitted as the
-     *  `amenityCategory` feature property the theme filters on. Amenities
-     *  only. See `amenityCategoryFor`. */
-    amenityCategory?: 'connector' | 'entrance' | 'parking' | 'bus' | 'other';
+     *  `'entrance'`, `'parking'`, `'bus'`, `'information'` or `'other'`.
+     *  Derived from the amenity's connector flag, name, type and keywords;
+     *  emitted as the `amenityCategory` feature property the theme filters on.
+     *  Amenities only. See `amenityCategoryFor`. */
+    amenityCategory?: 'connector' | 'entrance' | 'parking' | 'bus' | 'information' | 'other';
     /** Search keywords */
     keywords?: string[];
     /** Additional properties */
@@ -70,6 +80,12 @@ interface POI {
     /** For kiosk POIs only: compass heading the device physically faces, in
      *  degrees clockwise from north. Sourced from JACS `Device.heading`. */
     heading?: number | null;
+    /** Per-instance name for this specific placement of an amenity (e.g.
+     *  "Parking Lot A" for a "Parking" amenity), resolved from the waypoint's
+     *  `amenityAssociations`. Distinct from `name`, which is the amenity's
+     *  type-level name shared by every instance — see `Amenity.name`. Amenities
+     *  only, and only set when JACS actually returned an instance name. */
+    instanceName?: string;
 }
 /**
  * Amenity - a specific type of POI (facilities, services)
@@ -104,6 +120,17 @@ interface Amenity {
     waypoints?: Waypoint[];
     /** Amenity type/category */
     type?: string;
+    /**
+     * Locale-stable snapshot of `name + type + keywords`, captured once from
+     * the `/all` payload before `applyLocale` ever runs. `amenityCategoryFor`
+     * and the icon-rank heuristics in `poi.ts` match hard-coded English
+     * vocabulary against those fields; `name`/`keywords` are legitimately
+     * overwritten with translated text on a language switch
+     * (`LOCALIZED_FIELDS.amenity`), which reclassified every translated
+     * amenity to `'other'`/tier-3 and dropped its icon until the next zoom
+     * recomputed the rank gate. Classification reads this frozen copy instead.
+     */
+    classifyText?: string;
     /** Extended properties */
     extensors?: Record<string, unknown>;
 }
@@ -119,6 +146,12 @@ interface Destination {
     waypoints?: Waypoint[];
     /** Category/classification */
     category?: string;
+    /** Room number — the CMS's "Room Number" field. A **real JACS column**, not
+     *  one of the `mm_` stand-in extensors, so it arrives on the entity rather
+     *  than in `extensors`. Surfaced as `getPOIDetails().roomNumber`. */
+    unitNumber?: string | null;
+    /** Search keywords */
+    keywords?: string[];
     /** Additional properties */
     properties?: Record<string, unknown>;
     /** The CMS "Location Image" — a photo or logo for the popover, not a map
@@ -158,6 +191,15 @@ interface Waypoint {
      *  link between a location and its department — read at runtime across the
      *  data provider (see the package CLAUDE.md zone landmine). */
     zoneId?: string | number;
+    /** Per-instance names JACS attaches to this waypoint's amenities (e.g. a
+     *  "Parking" amenity placed twice as "Parking Lot A" / "Parking Lot B").
+     *  `id` matches an `Amenity.id`, not this waypoint — a waypoint can carry
+     *  more than one amenity, so a consumer must find the entry for the
+     *  specific amenity it's rendering rather than assuming index 0. */
+    amenityAssociations?: Array<{
+        id: string | number;
+        name: string;
+    }>;
 }
 /**
  * Amenity enriched with the floor it belongs to
@@ -218,17 +260,16 @@ type WayfindCenterMode = 'none' | 'destination' | 'route';
 /**
  * Per-call routing preferences forwarded to the wayfinding provider.
  *
- * - `accessible` — prefer accessible paths; providers should drop or heavily
- *   penalize edges marked inaccessible (stairs by default, anything else
- *   the provider's data flags).
- * - `avoidStairs` — hard-filter stairs from the graph.
+ * - `avoidStairs` — hard-filter stairs from the graph. Accessibility
+ *   preference otherwise comes from the CMS's per-path-type `weight`
+ *   (elevators score low, stairs/escalators score high) — see
+ *   `data/wayfinding/weights.ts` — not from a caller-supplied flag.
  *
  * The bundled stub provider doesn't compute routes; consumers wire a real
- * provider (see `mm-web-sdk-example/lib/wayfinding`) that reads these
- * flags when building edge weights.
+ * provider (see `mm-web-sdk-example/lib/wayfinding`) that reads this
+ * flag when building edge weights.
  */
 type RoutingOptions = {
-    accessible?: boolean;
     avoidStairs?: boolean;
 };
 
@@ -266,13 +307,18 @@ type StepBase = {
     floorId: number | null;
     /** Localized instruction text. */
     text: string;
-    /** Total walking distance within this step, in meters (rounded). */
-    distanceMeters?: number;
+    /** Total walking distance within this step, in feet (rounded). */
+    distanceFeet?: number;
     /** Landmark name used for anchoring, if any. */
     landmark?: string;
 };
 type DepartStep = StepBase & {
     type: 'depart';
+    /** Which way the traveller turns before walking off, relative to the
+     *  way they're facing at the origin. Absent when `originFacingBearing`
+     *  wasn't supplied (direction unknowable) or when the route heads
+     *  straight ahead. Consumers use it to pick the step's icon. */
+    initialTurn?: 'left' | 'right' | 'around';
 };
 type TurnStep = StepBase & {
     type: 'turn-left' | 'turn-right' | 'u-turn';
@@ -350,6 +396,11 @@ type AmenityBadgeStyle = {
     ringColor?: string;
     /** Ring width in logical px. Default `2`. */
     ringWidth?: number;
+    /** Extra inset between the icon and the badge's inner edge, in logical px
+     *  (applied on all sides). Default `0` — the icon fills ~85% of the disc
+     *  as before. Raise this if an icon's own artwork reaches close to its
+     *  viewBox edges and ends up touching the ring. */
+    padding?: number;
 };
 interface SDKOptions {
     debug?: boolean;
@@ -387,18 +438,67 @@ interface SDKOptions {
      * controls the automatic highlight on `routeReady`.
      */
     routeStepHighlight?: boolean;
+    /**
+     * Whether restroom pins that are too close together to draw individually
+     * collapse into a single Material `wc` badge. Defaults to `true`.
+     *
+     * Venues author men's and women's restrooms as two amenities a few metres
+     * apart. Both are wayfinding-critical (rank 0) and both draw on a layer that
+     * doesn't allow icon overlap, so without this MapLibre resolves the collision
+     * by hiding one of them outright until the camera is very close in. Grouping
+     * shows one badge in their place and hands back *all* the members when it's
+     * tapped, so the consumer can offer directions to each.
+     *
+     * Set `false` to opt out and get the raw collision behaviour back.
+     */
+    groupRestroomIcons?: boolean;
     initialFloor?: string | number;
     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.
+     * How far, in **metres** (default `0.3`, ≈1 ft), extruded interior polygons
+     * (restrooms, back-of-house, obstacles, connectors) are inset so their edges
+     * don't z-fight the neighbouring room block. A polygon too thin to survive
+     * the inset (it would keep under half its area, e.g. a ~0.3 m back-of-house
+     * perimeter band) is left at its original size rather than erased. Metres to match the theme's
+     * `fill-extrusion-height` values, which MapLibre defines in metres — unlike
+     * the distances shown to visitors, which are in feet. Was feet before this
+     * option changed units; a value of `1` is now ~3.3× thicker.
      */
     wallThickness?: number;
+    /**
+     * How much costlier a candidate on a **different floor** from the kiosk is
+     * treated when choosing the closest instance of an amenity (default `1.5`).
+     * Used by `findClosestByWalkTime`, and so by `navigateFromKioskToClosestAmenity`
+     * and `highlightAmenity`.
+     *
+     * A multiplier on the trip's effort — walk time plus the elevator wait — not
+     * a distance: `1.5` means another floor's instance has to be a third cheaper
+     * to beat one on the kiosk's floor. It is a *preference* for not making the
+     * visitor change floors, layered on top of the physical cost of doing so
+     * (which is already in the effort). `1` turns it off and ranks by effort
+     * alone; a value below `1` is treated as `1`. It only affects which instance
+     * is chosen — never a route.
+     *
+     * For scale: at the Las Vegas VA the nearest other-floor Lactation Pod costs
+     * ~400 ft-equivalent against ~530 for the one on the kiosk's floor, so it
+     * takes a value above ~1.32 to keep the visitor on their floor.
+     */
+    otherFloorPenalty?: number;
     boundsPadding?: BoundsPadding;
+    /**
+     * Caps how far a visitor can pan/zoom out. By default the SDK derives this
+     * from the venue's own bounds, scaled to 3x its width/height around the
+     * same center — enough room to pan around the building without drifting
+     * into an empty, un-tiled region. The default box is never smaller than
+     * ~3.7 km a side, so a small venue isn't forced to zoom in tighter than a
+     * large one. Pass a number to use a different
+     * multiplier (e.g. `1.5` for a tighter leash), explicit `[[west, south],
+     * [east, north]]` bounds to override entirely, or `false` to disable
+     * max-bounds clamping.
+     */
+    maxBounds?: Bounds | number | false;
     /**
      * Pitch (deg) for the opening view, applied centred on the kiosk ("You
      * are here"). Omit for top-down.
@@ -419,6 +519,16 @@ interface SDKOptions {
      * massing/region. `0` locks zoom-out exactly to the opening view.
      */
     minZoomBelowInitialFit?: number;
+    /**
+     * Zoom-out floor expressed as ground scale: the most metres one CSS pixel
+     * may span. The SDK converts it to a `minZoom` at the venue's latitude, so
+     * every venue shows the same amount of surrounding map when fully zoomed
+     * out — a plain zoom number doesn't, because Web Mercator shows less ground
+     * per zoom level the further a venue is from the equator. Takes precedence
+     * over `minZoomBelowInitialFit`. For scale, `1.207` is zoom 15.8 at Orlando
+     * (about 2.3 km x 1.3 km on a 1920x1080 screen).
+     */
+    minZoomMetersPerPixel?: number;
     /**
      * Override the colour the SDK recolours every amenity SVG to before it
      * composites the badge. `none` / `transparent` fills are preserved so
@@ -449,6 +559,21 @@ interface SDKOptions {
      * unless this is set explicitly.
      */
     connectorBadge?: AmenityBadgeStyle | false;
+    /**
+     * Badge for information-desk amenities (curated `information`/`info`
+     * icon). These render as their own visual class — a green disc with a
+     * white glyph by default — so information reads distinct from the gold
+     * service amenities. Pass `false` to fall them back into the regular gold
+     * badge, or an object to tune the disc / ring. When `amenityBadge` is
+     * `false`, information icons are badge-less too unless this is set
+     * explicitly.
+     */
+    informationBadge?: AmenityBadgeStyle | false;
+    /**
+     * Glyph colour for information icons on their badge. Default white
+     * (matches `informationBadge`'s default green disc).
+     */
+    informationIconColor?: string;
     styleMode?: 'venueStyleUrl' | 'sdkTemplate';
     templateOverrideMode?: 'colorsOnly' | 'colorsAndConstants' | 'all';
 }
@@ -748,8 +873,13 @@ declare class AmenityManager {
      * three times in a venue list); this collapses those into a single record
      * with all its waypoints merged across floors.
      *
-     * Also folds any duplicate-id records from the provider (a CMS data bug)
-     * into a single entry so React lists don't trip on dup keys.
+     * Also folds any duplicate-id records from the provider into a single entry
+     * so React lists don't trip on dup keys. This used to say those duplicates
+     * were "a CMS data bug" — they weren't. JACS returns one record per amenity;
+     * the SDK's own floor index pushed it once per waypoint, so an amenity with
+     * four placements on a floor came back four times. Fixed at the source in
+     * `jacsDataProvider.floorIdsForWaypoints`; the fold stays as a cheap guard
+     * for a provider that genuinely repeats an id.
      *
      * Use this for venue-wide browse UIs; pair it with `findClosestWaypoint`
      * (on the SDK) to resolve a tap to the nearest physical instance.
@@ -761,6 +891,175 @@ declare class AmenityManager {
     logKioskForFloor(floorId: Floor['id']): void;
 }
 
+/**
+ * The `mm_`-prefixed extensor keys the CMS reserves for fields JACS has no
+ * column for yet.
+ *
+ * This file is the read half of a cross-repo table: the write half is
+ * `cms/packages/map-manager/app/utils/reserved-extensors.js`, which owns the key
+ * names, the value encodings, and the rule that a default value is deleted
+ * rather than stored. Change them together.
+ *
+ * The `mm_` prefix is load-bearing on both sides. Authors can type anything into
+ * the CMS's free-form Properties editor, so an unprefixed key like
+ * `point_of_interest` could collide with a hand-entered one; the prefix also
+ * makes "is this key reserved?" a prefix scan rather than a hand-maintained list
+ * once JACS grows real columns and these are migrated away.
+ *
+ * Two things that look like they belong here and don't:
+ *
+ * - **Room number.** The CMS labels it "Room Number", but it writes the real
+ *   `Destination.unitNumber` field, not an extensor. `getPOIDetails().roomNumber`
+ *   reads that field (see `sdk.ts`).
+ * - **`mm_point_of_interest`.** Registered by the CMS and parsed here for
+ *   completeness, but deliberately not surfaced on `getPOIDetails` — nothing has
+ *   pinned down whether an unflagged destination should drop out of search, out
+ *   of the map, or neither, and guessing wrong is worse than omitting it.
+ */
+declare const RESERVED_EXTENSOR_PREFIX = "mm_";
+/** Weekly opening hours. Value shape and parser live in `openHours.ts`. */
+declare const OPEN_HOURS_EXTENSOR_KEY = "mm_open_hours";
+/** Phone number, with the extension folded into the same value. */
+declare const PHONE_EXTENSOR_KEY = "mm_phone";
+/** Alt text for the destination's uploaded Location Image. */
+declare const IMAGE_ALT_EXTENSOR_KEY = "mm_image_alt";
+/** Author-set "this is a point of interest" flag. Parsed, not surfaced. */
+declare const POINT_OF_INTEREST_EXTENSOR_KEY = "mm_point_of_interest";
+/**
+ * Which building on the campus the destination stands in.
+ *
+ * The venue's own `Building` record can't answer this: the CMS binds a venue to
+ * a single building and hangs the floor list off it, so a campus with a dozen
+ * numbered buildings has one `Building` and no way to say which one a room is
+ * in. The author types it as free text, and that text is what a kiosk prints —
+ * it is not a reference to anything, so don't try to resolve it against
+ * `venue.buildings`.
+ */
+declare const BUILDING_NAME_EXTENSOR_KEY = "mm_building_name";
+interface DestinationPhone {
+    /** Exactly as the author typed it — `"(408) 300-9294"`. Deliberately not
+     *  normalised: doing that properly across international formats needs a real
+     *  phone library, and the CMS makes the same choice on the way in. */
+    number: string;
+    /** Internal extension digits, when there is one. */
+    ext?: string;
+}
+/**
+ * `"(408) 300-9294;ext=123"` → `{ number, ext }`. `null` when there's no number
+ * — including for the empty string, which is how JACS spells a deleted key.
+ */
+declare function parsePhone(raw: unknown): DestinationPhone | null;
+/** Alt text for the Location Image, or `undefined` when the author set none. */
+declare function parseImageAlt(raw: unknown): string | undefined;
+/** The building name, or `undefined` when the author set none. */
+declare function parseBuildingName(raw: unknown): string | undefined;
+/** The point-of-interest flag. Absence means false — only the checked state is
+ *  ever stored. */
+declare function parsePointOfInterest(raw: unknown): boolean;
+
+/**
+ * Weekly opening hours for a destination.
+ *
+ * JACS has no hours column, so the CMS ships the whole week in a single
+ * destination extensor — key `mm_open_hours`, value a JSON string:
+ *
+ *   {"v":1,"days":{"mon":[["09:00","17:30"]],"sat":[],"sun":[["00:00","24:00"]]}}
+ *
+ * - Times are 24-hour `"HH:MM"` and **venue-local**; no timezone is recorded.
+ * - Each day maps to an array of `[open, close]` ranges. The editor exposes one
+ *   range per day today, but the array shape leaves room for split shifts (a
+ *   cafeteria that closes over the afternoon) and extra ranges round-trip.
+ * - An empty array — or a missing day — means closed.
+ * - `[["00:00","24:00"]]` means open 24 hours.
+ *
+ * This module owns the read half: parse the value (`parseOpenHours`) and derive
+ * the live open/closed state from it (`getOpenStatus`). The write half lives in
+ * the CMS (`map-manager`'s `utils/open-hours.js`) — the two must agree on the
+ * wire shape above, so change them together. The key itself is registered in
+ * `reservedExtensors.ts` alongside the CMS's other stand-in fields, mirroring
+ * the same split on the authoring side.
+ */
+
+/** Wire-format version this module understands. */
+declare const OPEN_HOURS_VERSION = 1;
+type DayKey = 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' | 'sun';
+/** Monday-first, matching the wire format's own day order. `getOpenStatus`
+ *  reports `OpenHoursTransition.day` as one of these. */
+declare const DAY_KEYS: readonly DayKey[];
+/** One open→close stretch within a single day. 24-hour `"HH:MM"`, venue-local.
+ *  `close` may be `"24:00"` (end of day); `open` never is. */
+interface HoursRange {
+    open: string;
+    close: string;
+}
+/** A parsed week. Every day is present; a closed day is an empty array. */
+interface OpenHours {
+    days: Record<DayKey, HoursRange[]>;
+    /** Open every minute of the week (a 24/7 emergency department, say). The
+     *  status has no `closesAt` in this case — there is nothing to count down to. */
+    alwaysOpen: boolean;
+}
+/** A point in the week the status is counting toward. */
+interface OpenHoursTransition {
+    /** Day the transition falls on, venue-local. */
+    day: DayKey;
+    /** 24-hour `"HH:MM"`, venue-local. Midnight is always `"00:00"` on the
+     *  following day — `"24:00"` never surfaces here. */
+    time: string;
+    /** Whole minutes from `now`. */
+    minutesUntil: number;
+    /** Calendar days ahead: `0` today, `1` tomorrow. */
+    daysAhead: number;
+}
+interface OpenStatus {
+    /** Open right now. */
+    open: boolean;
+    /** Open every minute of the week — no closing time to show. */
+    alwaysOpen: boolean;
+    /** Open, and closing within `soonMinutes`. */
+    closingSoon: boolean;
+    /** Closed, and opening within `soonMinutes`. */
+    openingSoon: boolean;
+    /** When open: the end of the current stretch. Absent when `alwaysOpen`. */
+    closesAt?: OpenHoursTransition;
+    /** When closed: the next time it opens. Absent when no day is open. */
+    opensAt?: OpenHoursTransition;
+}
+interface OpenStatusOptions {
+    /** How near a transition counts as "soon". Default `30`. */
+    soonMinutes?: number;
+    /** IANA zone the hours are expressed in (`'America/Denver'`). Omit — the
+     *  normal case for a kiosk standing in the venue — to read the host clock.
+     *  An unrecognised zone falls back to the host clock rather than throwing. */
+    timeZone?: string;
+}
+/**
+ * Extensor value → a parsed week, or `null` when there is nothing usable.
+ *
+ * Accepts the stored JSON string or an already-parsed object. Anything
+ * unreadable — absent key, malformed JSON, no open day — is `null` rather than
+ * a throw, so a bad value costs the consumer an omitted section, not a crash.
+ *
+ * An unknown `v` is also `null`, deliberately. A future version could add
+ * holiday overrides or a timezone; reading only the `days` it recognises would
+ * let the SDK announce "Open" on a day the venue marked closed, and a confidently
+ * wrong answer at a kiosk is worse than a missing one.
+ */
+declare function parseOpenHours(raw: unknown): OpenHours | null;
+/**
+ * The live open/closed state for a parsed week.
+ *
+ * Pure and time-explicit: pass the `now` you want evaluated (default: the
+ * moment of the call). Nothing is cached, so a consumer that wants a status
+ * that stays true — a kiosk card sitting open — re-calls this on a tick rather
+ * than holding the result.
+ *
+ * Hours carry no timezone of their own, so they are read against the host clock
+ * unless `options.timeZone` names the venue's zone. The kiosk case needs no
+ * option: the machine stands in the building it is describing.
+ */
+declare function getOpenStatus(hours: OpenHours, now?: Date, options?: OpenStatusOptions): OpenStatus;
+
 declare class MinuteMaps {
     private config;
     private map;
@@ -799,19 +1098,37 @@ declare class MinuteMaps {
     /** The `window` key `debug` mode installed this instance under, if any. */
     private debugGlobalKey;
     private defaultCamera;
+    /** This venue's opening zoom, captured once after the initial fit resolves.
+     *  Anchors the pinned zoom profile's icon/label reveal thresholds (idle
+     *  spotlight, active route) to this venue's own opening view rather than an
+     *  absolute MapLibre zoom, and the roof fill's fade-in. See `zoomViews`. */
+    private iconZoomBase;
+    /** Which layers show at which zoom: the Campus / Building / Kiosk views, or
+     *  the pinned profile while the idle spotlight or a route is up. Re-applied
+     *  after every `setTheme()` swap, since `setStyle({ diff: false })`
+     *  recreates layers from the pristine theme. */
+    private zoomViews;
     private viewModes;
     /** Mirror of `config.options.reducedMotion`, mutable via `setReducedMotion`. */
     private reducedMotion;
+    /** Whether map labels render in OpenDyslexic, mutable via `setDyslexicFont`.
+     *  Re-applied after every `setTheme()` swap, same reason as `iconZoomBase`. */
+    private dyslexicFont;
     /** Tracks the active theme name so `setTheme()` is a no-op when re-requested. */
     private activeThemeName;
     /** Tracks the active locale so `setLocale()` is a no-op when re-requested.
      *  Seeded from `config.jmap.locale` at construction; `undefined` means
      *  whatever the customer's default locale is on the JACS side. */
     private currentLocale;
+    /** The destination of the last successfully computed route — kept so
+     *  `setLocale()` can rebuild + re-emit `routeReady` with retranslated
+     *  step text without recomputing the path. Cleared on route failure. */
+    private lastRouteDestinationPoi;
     private amenityManager;
     private wayfinding;
     private highlightManager;
     private selectionManager;
+    private restroomGroups;
     /** Captured unit paint values to restore when the selection clears, or
      *  `null` when no room is currently focused. See `UNIT_DIM_TARGETS`. */
     private unitDimRestore;
@@ -823,6 +1140,23 @@ declare class MinuteMaps {
      *  *previous* filters, not the ids) so `setTheme` can re-apply the same focus
      *  to the new style's layers after a swap discards the old ones. */
     private destFocusIds;
+    /** The predicate currently narrowing the POI marker layers to a curated set,
+     *  or `null` when no spotlight is active. See `setPOISpotlight`. Held as the
+     *  predicate, not a resolved id list, so a floor change or locale redraw can
+     *  re-resolve it against the POIs now on screen. */
+    private poiSpotlight;
+    /** Layer filters as they were before the spotlight narrowed them, put back
+     *  verbatim when it releases. `null` when no spotlight filter is applied. */
+    private poiSpotlightRestore;
+    /** Coordinates of the current tap/Info selection, or `null` when nothing is
+     *  selected. `easeToSelection` reads `getBoundsPadding()` at the moment a
+     *  selection is made, which is often *before* the consumer's info card has
+     *  mounted and been measured into that padding — so the first pan can land
+     *  the POI behind the card. Kept here so `setBoundsPadding` can re-nudge the
+     *  camera once the consumer measures its now-mounted chrome and reports
+     *  fresh insets, the same way it already re-fits an active route. Cleared by
+     *  `clearHighlight`. */
+    private selectedCoordinates;
     private youAreHerePulse;
     /** Theme layers whose features represent a tappable destination/amenity.
      *  A click hit-tests these (see `SelectionManager`) → `poiSelected`. The
@@ -836,6 +1170,15 @@ declare class MinuteMaps {
      *  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;
+    /** The kiosk's own "you are here" pin — icon, directional heading wedge,
+     *  and the ring drawn behind them. Deliberately **not** part of
+     *  `CLICKABLE_POI_LAYERS`: that list feeds `emitPoiSelected`, which opens
+     *  a selection card for a destination/amenity, and this pin isn't one —
+     *  it's where the kiosk itself is standing. A tap here means "where am
+     *  I", so it gets its own delegated listener emitting `youAreHereClicked`
+     *  instead, for a consumer to wire to the same recenter action as its
+     *  own recenter control. */
+    private static readonly YOU_ARE_HERE_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
@@ -857,7 +1200,20 @@ declare class MinuteMaps {
      *  `poi-highlight-*` layers — are intentionally unaffected; they're
      *  anchors or transient focus state, not categorical content. */
     private static readonly POI_CATEGORY_LAYERS;
+    /** Marker layers `setPOISpotlight` narrows. Every categorical POI layer
+     *  except `poi-other-amenity-icons`, whose filter the restroom-group manager
+     *  and the zoom-range pass rewrite as the camera moves — a spotlight
+     *  narrowing would be silently overwritten mid-orbit — plus the per-instance
+     *  amenity label, which is a marker in every sense but isn't a category. */
+    private static readonly POI_SPOTLIGHT_LAYERS;
     private poiVisibleTypes;
+    /** Independent show/hide state for destination dots and name labels, set
+     *  by `setDestinationCirclesVisible`/`setDestinationLabelsVisible`. Kept
+     *  separate from `poiVisibleTypes` so the two controls compose instead of
+     *  clobbering each other — `applyPOIFilter` and `applyDestinationDisplay`
+     *  each own one paint/layout axis of the same layers. */
+    private destinationCirclesVisible;
+    private destinationLabelsVisible;
     constructor(config: SDKConfig);
     init(): Promise<void>;
     /**
@@ -883,6 +1239,16 @@ declare class MinuteMaps {
     off(event: string, cb?: (e: MapEvent) => void): void;
     addControl(control: IControl, position?: ControlPosition): void;
     setView(options: ViewOptions): void;
+    /**
+     * Force a camera move to land instantly while reduced motion is on.
+     *
+     * The single gate every consumer-driven move goes through — zoom
+     * buttons, compass reset, go-home, recenter, route fits — so the one
+     * toggle covers them all instead of each call site remembering to ask.
+     * Returns `opts` untouched when the preference is off, so a caller that
+     * asked for `animate: false` keeps it either way.
+     */
+    private motionGated;
     get amenities(): AmenityManager;
     resetView(opts?: {
         animate?: boolean;
@@ -921,10 +1287,13 @@ declare class MinuteMaps {
      * `styleimagemissing`; everything else must be re-run explicitly here or
      * it silently goes blank after a theme swap.
      *
-     * `themeName === 'high-contrast'` recolors the amenity badge disc to
-     * `HIGH_CONTRAST_AMENITY_BADGE_COLOR`, leaving ring/glyph colors and
-     * connector (elevator/stairs/escalator) badges untouched. Failures per
-     * icon set are logged and skipped so one bad icon doesn't block the rest.
+     * `themeName === 'high-contrast'` recolors both the amenity badge disc
+     * and the connector (elevator/stairs/escalator) badge disc to
+     * `HIGH_CONTRAST_AMENITY_BADGE_COLOR`, and forces both the regular and
+     * connector glyph to `HIGH_CONTRAST_AMENITY_ICON_COLOR` so neither
+     * washes out against its now-yellow disc and the two match each other.
+     * Ring colors are left untouched. Failures per icon set are logged and
+     * skipped so one bad icon doesn't block the rest.
      */
     private registerRuntimeIcons;
     /**
@@ -939,12 +1308,39 @@ declare class MinuteMaps {
     /** Currently active theme name (or `'custom'` when a raw style was passed). */
     getActiveTheme(): 'default' | 'high-contrast' | 'custom';
     /**
-     * Update the SDK's reduced-motion preference at runtime. When true,
-     * imperative camera animations (route fits, idle re-frames) and the
-     * route line-draw animation run with `duration: 0`.
+     * Update the SDK's reduced-motion preference at runtime. When true, every
+     * imperative camera move (`setView`, `resetView`, `refit`, recenter, route
+     * fits, selection pans, floor fits) runs with `duration: 0`, and every
+     * looping animation the SDK drives — the route line-draw, the flowing route
+     * arrows, the "You are here" pulse, the selection ring's ping — is stopped.
+     *
+     * Anything already on screen is switched over here, not just on the next
+     * action: a visitor who flips the toggle mid-route is doing it *because* of
+     * the motion they can see, so waiting for the next event would be the one
+     * moment the preference doesn't work.
      */
     setReducedMotion(enabled: boolean): void;
     getReducedMotion(): boolean;
+    /**
+     * Swap every map label (street names, POI names, building labels, "You are
+     * here") between the bundled themes' default font and OpenDyslexic. Mirrors
+     * the DOM-side dyslexic-font accommodation onto the canvas, which CSS can't
+     * reach.
+     *
+     * Goes through the same local-glyph fallback the themes already use for
+     * `Material Icons` (`LOCAL_GLYPH_FONTS`): `text-font` values are swapped to
+     * fontstack names intentionally absent from the glyph server
+     * (`OpenDyslexic Bold` etc.), so MapLibre rasterizes them from a
+     * page-loaded `@font-face` instead. The consuming app owns loading that
+     * font — the SDK ships no assets — so this is a no-op glyph-wise (labels
+     * fall back to tofu-free default rendering) if the app never declared it.
+     *
+     * Re-applied after `setTheme()`, since `setStyle({ diff: false })`
+     * recreates every layer from the pristine (non-dyslexic) theme JSON.
+     */
+    setDyslexicFont(enabled: boolean): Promise<void>;
+    getDyslexicFont(): boolean;
+    private applyDyslexicFontToLabels;
     /**
      * Switch the locale used for POI / amenity / destination / floor names at
      * runtime. The SDK refetches localized names from JACS (per-entity
@@ -958,9 +1354,12 @@ declare class MinuteMaps {
      * Emits a `localeChanged` event with the new code after the patch
      * completes. No-op when the code matches the current locale.
      *
-     * Throws if the underlying data provider doesn't implement locale support
-     * (only `JacsDataProvider` does today), or if the JACS fetch fails — the
-     * prior locale is left intact in that case.
+     * Throws only on programmer error — a provider without locale support
+     * (only `JacsDataProvider` has it today) or an empty code. A **failed
+     * JACS fetch is not fatal**: the locale still switches and is reported,
+     * it's only the localized names that stay on the prior language. That
+     * split is deliberate — generated directions text ships inside the SDK
+     * and must not be held hostage to a network round-trip.
      */
     setLocale(locale: string): Promise<void>;
     /** Currently active locale (BCP-47), or `undefined` when no locale has
@@ -992,15 +1391,53 @@ declare class MinuteMaps {
         type: 'amenity' | 'destination' | 'kiosk';
         category?: string;
         floorName?: string;
+        floorShortName?: string;
         zoneName?: string;
         zoneDescription?: string;
+        /** The department's authored hex colour (`Zone.color`) — the same value
+         *  that tints this room's polygon on the map, so a consumer can print a
+         *  swatch beside the department name and connect the two. Absent when the
+         *  author never picked one, which is also when the map leaves the room
+         *  untinted; treat "no colour" as "this department isn't colour-coded",
+         *  not as "fall back to a default swatch". */
+        zoneColor?: string;
         keywords?: string[];
         description?: string;
+        /** CMS-authored extras from the entity's `extensors` bag (opening hours,
+         *  days, room, building). Free-form — the consumer decides what to render.
+         *  Artwork is not in here; see `imageUrl`. */
+        properties?: Record<string, unknown>;
         /** The destination's uploaded location image, ready for an `<img src>`.
          *  Destinations only — amenities use sprite glyphs, not photos. Inline SVG
          *  from `/all` comes back as a data URI; otherwise it's the uploaded uri
          *  path. Absent when nothing was uploaded in the CMS. */
         imageUrl?: string;
+        /** Author-written alt text for `imageUrl` (`mm_image_alt`) — a description
+         *  of the place, for screen readers and for anyone the image fails to load
+         *  for. Absent when the author wrote none, in which case the image is
+         *  decorative and belongs in an `<img alt="">`, not an unlabelled one. */
+        imageAlt?: string;
+        /** Room number — the CMS's "Room Number". Reads the real
+         *  `Destination.unitNumber` column, falling back to a legacy hand-typed
+         *  `room_number` property for venues authored before that field existed. */
+        roomNumber?: string;
+        /** Which building on the campus this destination is in (`mm_building_name`),
+         *  as the author typed it — "200", "Ambulatory Care". Free text, not a
+         *  reference to a `Building` record; render it, don't resolve it. Falls back
+         *  to the legacy hand-typed `building_name` property, which is unprefixed
+         *  and therefore a different key. */
+        buildingName?: string;
+        /** Phone number and internal extension (`mm_phone`). The number is exactly
+         *  as the author typed it, not normalised — see `parsePhone`. */
+        phone?: DestinationPhone;
+        /** The CMS-authored opening hours (`mm_open_hours`), parsed. Absent when
+         *  the author set none, or the stored value is unreadable.
+         *
+         *  Static — it describes the week, not this moment. Pass it to
+         *  `getOpenStatus()` for the live open/closed state, and re-call that on a
+         *  tick if the UI stays on screen. The raw string also remains in
+         *  `properties` for consumers that would rather parse it themselves. */
+        openHours?: OpenHours;
     };
     /** Resolve the source Destination/Amenity record backing a rendered POI,
      *  for detail fields (category, localized description) that don't live on
@@ -1028,6 +1465,40 @@ declare class MinuteMaps {
     private reportLayerAudit;
     getFloorMapTemplate3d(floorId: string | number): any[];
     getAllPOIs(floor?: Floor): POI[];
+    /**
+     * Put the map on the kiosk's floor before drawing a route from it.
+     *
+     * **A route from the kiosk always starts on the kiosk's floor**, so that is
+     * the floor the visitor has to be looking at when it appears. The renderer
+     * agrees with that already — `wayfinding` reveals and frames *the active
+     * floor's* slice of the route — which is exactly why this matters: leave the
+     * map where the visitor had wandered to and the route arrives framed on the
+     * wrong leg, or on no leg at all.
+     *
+     * Both halves of that were reported from a real kiosk. Browse up to Level 3,
+     * search, press Directions: if Level 3 isn't on the route the fit falls back
+     * to the union of every floor and nothing reads as a path from here; if it
+     * *is* on the route — because the destination is up there — the visitor is
+     * looking at the last leg of a walk they haven't started, with no indication
+     * that the first one is two floors down.
+     *
+     * Called before the route is computed rather than after it's drawn, so the
+     * camera makes one move instead of fitting the wrong floor and correcting.
+     * No-op when the venue has no kiosk anchor (those routes fail anyway) or the
+     * map is already there.
+     */
+    private showKioskFloorForRoute;
+    /**
+     * The floor the kiosk is physically anchored to — not necessarily the
+     * floor currently displayed (the visitor may have panned the floor
+     * selector to preview a destination on another level, and the SDK opens
+     * on the venue's configured default floor rather than the kiosk's own —
+     * see `FloorManager.selectInitialFloor`). Anchor resolution (routing,
+     * recentering, closest-waypoint) must resolve against this floor, never
+     * `getCurrentFloor()`, or it silently misses the "you are here" POI
+     * whenever the two diverge. `null` when the venue has no kiosk anchor.
+     */
+    getKioskFloor(): Floor | null;
     getYouAreHerePOI(floor?: Floor): POI | null;
     getYouAreHereCoordinates(floor?: Floor): [number, number] | null;
     /**
@@ -1042,6 +1513,14 @@ declare class MinuteMaps {
      * cone rendered next to the "You are here" marker.
      */
     getKioskHeading(): number | null;
+    /**
+     * Bearing (degrees clockwise from north) the visitor at the kiosk is
+     * FACING — the device heading rotated 180°, since they stand in front
+     * of the screen looking back at it. `null` when the device record
+     * carries no heading, in which case direction-relative wording ("turn
+     * right and walk 40 ft") is suppressed rather than guessed.
+     */
+    private getVisitorFacingBearing;
     /**
      * Display name of the JACS device the kiosk is anchored to (e.g.
      * "Main Lobby Kiosk", "Information Desk Kiosk"). `null` when the venue
@@ -1064,8 +1543,14 @@ declare class MinuteMaps {
      * `{ id, mapId? }` shape. Returns `null` when the kiosk isn't anchored,
      * the target waypoint isn't on the graph, or no path resolves.
      *
-     * Walking speed defaults to 1.2 m/s (indoor wayfinding norm). Pass
-     * `walkingSpeedMps` to estimate for accessibility (e.g. 0.9).
+     * Walking speed defaults to 2.953 ft/s (0.9 m/s, average adult walking speed —
+     * PMC2967707). Pass `walkingSpeedFps` to estimate for accessibility (e.g. 2).
+     *
+     * `feet` / `seconds` are the *physical* walk — horizontal legs only, what a
+     * visitor is shown. `effortSeconds` adds the router's charge for each floor
+     * change (the elevator wait) and is what to *rank* candidates by; see
+     * `findClosestByWalkTime`. Pass `avoidStairs` to price the path as a route
+     * with that option would be.
      */
     getWalkTimeFromKiosk(target: number | string | {
         id?: number | string;
@@ -1075,10 +1560,12 @@ declare class MinuteMaps {
             id?: number | string;
         }>;
     }, opts?: {
-        walkingSpeedMps?: number;
+        walkingSpeedFps?: number;
+        avoidStairs?: boolean;
     }): {
-        meters: number;
+        feet: number;
         seconds: number;
+        effortSeconds: number;
         pathNodeCount: number;
     } | null;
     /**
@@ -1112,8 +1599,6 @@ declare class MinuteMaps {
     wayfindBetweenWaypoints(fromWaypoint: any, toWaypoint: any, options?: {
         centerMode?: 'none' | 'destination' | 'route';
         zoom?: number;
-        /** Prefer accessible paths (drops or penalizes stairs / inaccessible edges). */
-        accessible?: boolean;
         /** Hard-filter stairs from the graph. */
         avoidStairs?: boolean;
     }): Promise<any>;
@@ -1126,12 +1611,23 @@ declare class MinuteMaps {
      * you want a visual focus rather than a route.
      */
     navigateFromKioskToPOI(poi: POI, options?: {
-        accessible?: boolean;
         avoidStairs?: boolean;
     }): Promise<any>;
     /** Build the landmark / floor-name context the directions module needs.
      *  Pulled out so `setLocale()` or `setActiveStep()` can rebuild it on
      *  demand if we ever surface a locale-aware variant. */
+    /**
+     * Rewrite every source whose features carry venue-authored *text* for a
+     * floor: POI labels and map labels. Both read their names straight out of
+     * the venue model, so anything that mutates that model in place — today
+     * `setLocale`'s translation patch — has to call this or the map keeps
+     * rendering the old strings until the next floor change.
+     *
+     * Map labels ride the same lifecycle as POIs and carry the `allLevels`
+     * flag, which the projector has already honored by duplicating the
+     * instance under every floor's list.
+     */
+    private redrawFloorText;
     private buildDirectionsContext;
     /**
      * Drive the turn-by-turn UI. Two effects:
@@ -1160,6 +1656,42 @@ declare class MinuteMaps {
      * it lives on another one. Pass a POI / amenity / destination id.
      */
     highlightPOI(id: string | number): Promise<void>;
+    /**
+     * Select a POI programmatically — the same end state as tapping it on the
+     * map, from a list or any other chrome.
+     *
+     * Switches the active floor first when the POI lives on another one, raises
+     * its room as a highlighted block, mutes the neighbouring units, declutters
+     * to the selected destination(s), pans it into the unobscured map area and
+     * emits **`poiSelected`** carrying every co-located POI. A consumer that
+     * already renders an info card off that event therefore needs no second code
+     * path: a tap and a list pick arrive the same way.
+     *
+     * This is deliberately *not* `highlightPOI`, which is the search-locate
+     * gesture — it zooms and recenters and draws a pulsing ring, and emits
+     * nothing. Selection is the quieter one: current zoom kept, no ring, the
+     * raised room is the indicator.
+     *
+     * Accepts a `POI` (preferred — its `type` and `waypointId` pin down the exact
+     * instance, which matters for an amenity that shares one id across every
+     * physical pin) or a bare id.
+     *
+     * **`includeCoLocated: false` emits only the requested POI.** By default the
+     * payload carries everything sharing the room, which is right when the
+     * gesture was a tap — the visitor pointed at a place on a floor plan and the
+     * consumer has to show them what's there. It's wrong when they picked one
+     * entry out of a named list: they have already disambiguated, and handing
+     * back four places would ask them to do it again, on a card that opened
+     * *because* they were specific. The map treatment is identical either way
+     * (same room raised, same neighbours muted, same pan); only the payload —
+     * and so the declutter's allow-list — narrows.
+     *
+     * Returns the selected POIs, `pois[0]` being the requested one; an empty
+     * array if no POI matched, which is also when nothing on the map changes.
+     */
+    selectPOI(target: POI | string | number, options?: {
+        includeCoLocated?: boolean;
+    }): Promise<POI[]>;
     /** 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;
@@ -1217,7 +1749,69 @@ declare class MinuteMaps {
     setPOIFilter(types: Array<'amenity' | 'destination'>): void;
     /** Restore the default — every POI category renders. */
     clearPOIFilter(): void;
+    /**
+     * Narrow the POI markers to a curated set: only POIs for which `match`
+     * returns true keep their icon and label, every other pin on the categorical
+     * marker layers (destinations, entrances, parking, bus, connectors,
+     * information, and the per-instance amenity names) is filtered out. Built for
+     * an attract loop that wants a few chosen places on screen instead of either
+     * every marker or none.
+     *
+     * `match` runs against the current floor's POIs — the same objects
+     * `getAllPOIs()` returns, `instanceName` and `amenityCategory` included — and
+     * is re-run on every floor change, theme swap and locale redraw, so the
+     * spotlight follows the map rather than the floor it was set on. Kiosk
+     * "You are here" is never touched.
+     *
+     * Two things it deliberately leaves alone:
+     * - `poi-other-amenity-icons` and the restroom badge. Their filters are owned
+     *   by the restroom-group manager and rewritten as the camera moves, so a
+     *   narrowing there would not survive a frame. Hide them with `hideLayers`
+     *   if the spotlight should exclude them.
+     * - `setPOIFilter`'s category visibility, which composes: a category the
+     *   filter hides stays hidden whatever `match` says.
+     *
+     * Selecting a place (`selectPOI`, a map tap) releases the spotlight. Pass
+     * `null` — or call `clearPOISpotlight()` — to restore every marker.
+     */
+    setPOISpotlight(match: ((poi: POI) => boolean) | null): void;
+    /** Re-apply the zoom profile if the idle spotlight or a route just changed
+     *  which one is in force, and refresh what hangs off it. */
+    private syncZoomViews;
+    /** Restore every POI marker narrowed by `setPOISpotlight`. */
+    clearPOISpotlight(): void;
+    private applyPOISpotlight;
     private applyPOIFilter;
+    /**
+     * Show or hide destination dots, independently of their name labels and of
+     * `setPOIFilter`'s combined `'destination'` category (which still toggles
+     * both together). Affects every destination dot — both the dot+label
+     * marker on `poi-destination-labels` and the dot-only fallback on
+     * `poi-destination-circles` that a `showLabel: false` POI renders on.
+     *
+     * Implemented as `icon-opacity`, not a layer swap: dot and label are
+     * placed as one collision unit on `poi-destination-labels` (`icon-optional:
+     * false` / `text-optional: true`), which is what guarantees a label never
+     * renders without a dot beneath it. Splitting them into independently
+     * *placed* layers would let MapLibre's collision index resolve each half
+     * on its own, so a label could win placement while its dot lost — the
+     * "floating name" bug this theme's combined layer was built to fix (see
+     * `themes.test.ts` :: "a destination is one marker").
+     */
+    setDestinationCirclesVisible(visible: boolean): void;
+    /**
+     * Show or hide destination name labels, independently of their dots. See
+     * `setDestinationCirclesVisible` for why this is an opacity toggle on the
+     * shared marker layer rather than a separate label layer.
+     *
+     * `visible: true` (the default) doesn't mean "always on" — labels still
+     * fade in only once the visitor has zoomed in past the venue's opening
+     * view (`DESTINATION_LABEL_REVEAL_OFFSET` in `iconZoomRanges.ts`), so a
+     * zoomed-out visitor sees dots without the screen filling with names. Pass
+     * `false` to suppress labels outright regardless of zoom.
+     */
+    setDestinationLabelsVisible(visible: boolean): void;
+    private applyDestinationDisplay;
     /**
      * Return the waypoint in `waypoints` closest to `from`. Useful for
      * "route to the nearest X" against a venue-wide amenity record that has
@@ -1228,26 +1822,50 @@ declare class MinuteMaps {
      * single-venue scale, and avoids a turf dependency on the hot path.
      */
     findClosestWaypoint(waypoints: Waypoint[], from?: [number, number]): Waypoint | null;
+    /**
+     * Pick the candidate cheapest to reach from the kiosk — the one rule for
+     * "closest instance of an amenity". `navigateFromKioskToClosestAmenity` and
+     * `highlightAmenity` use it, and a consumer collapsing a venue-wide amenity
+     * to a single search row should too, so a tap and a search result can never
+     * resolve the same amenity to different floors.
+     *
+     * Each candidate is scored by `getWalkTimeFromKiosk().effortSeconds` — walk
+     * time over the JACS path graph **plus the elevator wait** for any floor
+     * change — and a candidate on a *different floor* from the kiosk has that
+     * score multiplied by `options.otherFloorPenalty` (default `1.5`; `1`
+     * disables it). The wait is the physical cost of leaving the floor; the
+     * multiplier is a preference for not making the visitor do it, and only
+     * applies here — it never changes a route.
+     *
+     * `toWaypoint` maps a candidate to the waypoint it stands for (identity for
+     * a `Waypoint[]`, `poi => poi.waypoint` for a `POI[]`). Candidates whose
+     * waypoint is missing or has no coordinates are ignored, as are waypoints
+     * the graph can't reach from the kiosk. If none resolve a cost, falls back
+     * to the planar `findClosestWaypoint`, **restricted to the kiosk's floor
+     * when any candidate is on it** (planar distance is meaningless across
+     * overlaid floors). Returns `null` for no usable candidate. Pass the same
+     * `avoidStairs` the route will use so the pick and the route agree.
+     */
+    findClosestByWalkTime<T>(items: readonly T[], toWaypoint: (item: T) => Waypoint | null | undefined, opts?: {
+        avoidStairs?: boolean;
+    }): T | null;
     /**
      * Route from the kiosk to the closest physical instance of an amenity.
      * Resolves the amenity venue-wide, picks the instance with the smallest
-     * path-graph walk time from the kiosk (falling back to planar Euclidean
-     * when the walk-time graph can't resolve any waypoint), switches the
+     * path-graph cost from the kiosk (`findClosestByWalkTime`: walk time plus
+     * the elevator wait, with a preference for the kiosk's floor; falling back
+     * to planar Euclidean when the walk-time graph can't resolve any waypoint), switches the
      * active floor if needed, and routes via the same plumbing as
      * `navigateFromKioskToPOI` — so step-by-step directions, the
      * `routeReady` event, and the active-floor camera fit all "just work."
      *
-     * Pass `accessible` / `avoidStairs` to weight the *route* (the SDK's
-     * routing engine reads these per call). Note: closest-instance picking
-     * itself is currently distance-based and does not yet honor those
-     * weights — the underlying walk-time graph applies pixel-length only.
-     * In practice this matters when an amenity has multiple instances and
-     * the geometrically closest is reachable only via stairs; the picked
-     * instance won't change today, but the *route* to it will avoid stairs
-     * (or fail gracefully) if `accessible`/`avoidStairs` is set.
+     * Pass `avoidStairs` to hard-filter stairs from the *route* (the SDK's
+     * routing engine reads it per call; the CMS's per-path-type weight
+     * otherwise handles accessibility preference automatically). The same
+     * flag is passed to the closest-instance pick, so an instance reachable
+     * only by stairs is skipped in favour of one the route can actually reach.
      */
     navigateFromKioskToClosestAmenity(amenityId: string | number, options?: {
-        accessible?: boolean;
         avoidStairs?: boolean;
     }): Promise<any>;
     /**
@@ -1268,6 +1886,32 @@ declare class MinuteMaps {
     private findFloorForWaypoint;
     getCameraPosition(): CameraState | null;
     getMap(): Map | null;
+    /**
+     * Hide one or more layers by id — a public, always-live counterpart to
+     * `debug.hide()` for consumers that want to toggle arbitrary layers
+     * without reaching into the console-facing debug API. Sticky: the
+     * override is re-asserted across floor changes, `setPOIFilter`, view-mode
+     * toggles and theme swaps until `showLayers` undoes it. Ids absent from
+     * the active style are skipped silently. Returns the ids actually found
+     * and hidden.
+     */
+    hideLayers(layerIds: string[]): string[];
+    /**
+     * Undo `hideLayers` for these ids. Each layer returns to whatever
+     * visibility the SDK's own state — current floor, POI filter, view mode —
+     * says it should have; it is **not** forced to `visible`. A layer the SDK
+     * is independently keeping hidden (another floor's layers, an
+     * off-view-mode extrusion) stays hidden rather than being force-revealed.
+     * This is the correct inverse of `hideLayers` (mirrors `debug.restore()` —
+     * see `debugLayers.ts` for why a blanket "show" is usually the wrong
+     * undo). Returns the ids that actually had an override to release.
+     */
+    showLayers(layerIds: string[]): string[];
+    /**
+     * Whether a layer is currently rendering (`visibility !== 'none'`).
+     * `false` for a layer absent from the active style.
+     */
+    isLayerVisible(layerId: string): boolean;
     /**
      * Put this instance on `window` so a kiosk running in a browser can be
      * driven from devtools — `mm.debug.help()`, `mm.getMap()`, `mm.setTheme(…)`.
@@ -1311,6 +1955,19 @@ declare class MinuteMaps {
      */
     private clampPadding;
     private getVenueBounds;
+    /**
+     * Resolve `options.maxBounds` into the actual pan/zoom-out cap. `false`
+     * disables it, explicit bounds pass through as-is, and a number (or the
+     * unset default of 3) scales the venue's own bounds outward around its
+     * center — see `scaleBounds`.
+     *
+     * The unset default is also floored at `DEFAULT_MIN_MAX_BOUNDS_SPAN_M` per
+     * side. MapLibre won't zoom out past the point where `maxBounds` fills the
+     * viewport, so a small venue's 3x box would otherwise raise the effective
+     * zoom-out floor above `minZoom` and show far less surrounding map than a
+     * large venue does. An explicit number is a deliberate leash and is left as-is.
+     */
+    private getMaxBounds;
     /**
      * Opening-framing policy applied once after the initial floor fit.
      *  - `initialPitch`: tilt to this and re-fit the building footprint so the
@@ -1364,5 +2021,76 @@ 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, EventCallback, Floor, FloorMetadata, JMapAuth, JMapConfig, JacsAuth, JacsConfig, MapEvent, POI, POISearchResult, RouteFloorSection, RoutePoint, RoutingOptions, SDKConfig, SDKOptions, ThemeName, TransitionStep, ViewOptions, WayfindCenterMode, WayfindStep, Waypoint, Zone };
+/** True when an amenity is a vertical-circulation connector. The provider
+ *  stamps `_connector` on every synthetic elevator / stairs / escalator, which
+ *  is the reliable signal — `extensors.iconName` is only the *display* glyph
+ *  and may be any CMS-assigned icon (we still honour it as a fallback for
+ *  amenities authored with a connector icon name directly). */
+declare function isConnectorAmenity(amenity: AmenityLike): boolean;
+type LocaleField = {
+    locale?: string;
+    uriPath?: string;
+};
+type UriField = {
+    mimeType?: string;
+    resourceType?: string;
+    locales?: LocaleField[];
+};
+type AmenityLike = {
+    id: number | string;
+    iconId?: string;
+    uris?: UriField[] | null;
+    /** Inline SVG markup. Used by the SDK for synthetic connector
+     *  amenities (elevator / stairs / escalator) where the CMS has no
+     *  uploaded icon to fetch. When set, this short-circuits the
+     *  `uris[].locales[].uriPath` lookup. */
+    svg?: string;
+    /** Free-form CMS metadata. When `extensors.iconName` names a curated
+     *  Material Symbols icon, the SDK renders it from the bundled registry
+     *  (no upload, no network) — see `pickMaterialSvg`. */
+    extensors?: Record<string, unknown> | null;
+    /** Set by the JACS provider on synthetic vertical-circulation amenities
+     *  (elevator / stairs / escalator built from path types). The reliable
+     *  connector signal — `extensors.iconName` is the *display* glyph, which
+     *  may be any CMS-assigned icon, not the connector kind. */
+    _connector?: boolean;
+};
+type ResolvedIconSource = {
+    /** Map image id to register/reference. Shared across amenities for
+     *  connectors (preset) and curated Material icons (`material-<name>`). */
+    iconId: string;
+    /** Source for `composeAmenityBitmap` — exactly one of url / inlineSvg. */
+    source: {
+        url?: string;
+        inlineSvg?: string;
+    };
+    /**
+     * Where the artwork came from. The map doesn't care — it rasterises all
+     * three the same way — but a DOM consumer must, because provenance decides
+     * both trust and styling:
+     *
+     * - `material` — from the SDK's bundled registry. Ours, so it's safe to
+     *   inline into the DOM, and safe to recolour (it's a monochrome glyph).
+     * - `inline` — an `svg` string off the CMS record. **Author-supplied
+     *   markup**: an inline `<svg>` can carry `<script>`, so render it through
+     *   an `<img src="data:…">` (which never executes script), not
+     *   `dangerouslySetInnerHTML`.
+     * - `upload` — a URL to a CMS-uploaded file. Also author-supplied, also an
+     *   `<img>`; and it arrives in whatever colours the author chose, so don't
+     *   assume you can tint it to match a badge.
+     */
+    kind: 'material' | 'inline' | 'upload';
+};
+/**
+ * Pure icon-source resolution by precedence — no map/DOM side effects, so it's
+ * unit-testable:
+ *   1. inline svg          — explicit inline-SVG override (rare)
+ *   2. extensors.iconName  — curated Material icon (bundled, shared bitmap);
+ *                            also how synthetic connectors render now
+ *   3. uris[].uriPath      — legacy / custom-uploaded SVG (fetched)
+ * Returns null when the amenity has no resolvable icon.
+ */
+declare function resolveAmenityIconSource(amenity: AmenityLike, preferredLocale?: string): ResolvedIconSource | null;
+
+export { BUILDING_NAME_EXTENSOR_KEY, DAY_KEYS, IMAGE_ALT_EXTENSOR_KEY, MinuteMaps, OPEN_HOURS_EXTENSOR_KEY, OPEN_HOURS_VERSION, PHONE_EXTENSOR_KEY, POINT_OF_INTEREST_EXTENSOR_KEY, RESERVED_EXTENSOR_PREFIX, activeSectionIndex, createMinuteMapsSDK, getOpenStatus, groupStepsIntoFloorSections, isConnectorAmenity, parseBuildingName, parseImageAlt, parseOpenHours, parsePhone, parsePointOfInterest, resolveAmenityIconSource };
+export type { Amenity, AmenityBadgeStyle, AmenityWithFloor, Bounds, BoundsPadding, CameraState, DayKey, Destination, DestinationPhone, EventCallback, Floor, FloorMetadata, HoursRange, JMapAuth, JMapConfig, JacsAuth, JacsConfig, MapEvent, OpenHours, OpenHoursTransition, OpenStatus, OpenStatusOptions, POI, POISearchResult, ResolvedIconSource, RouteFloorSection, RoutePoint, RoutingOptions, SDKConfig, SDKOptions, ThemeName, TransitionStep, ViewOptions, WayfindCenterMode, WayfindStep, Waypoint, Zone };