@minmaps-dev/mm-web-sdk 1.0.0-rc.40 → 1.0.0-rc.42

package/dist/index.d.ts

@@ -1349,8 +1349,7 @@ declare class MinuteMaps {
      * 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
+     * Goes through MapLibre's local-glyph fallback: `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
@@ -1398,6 +1397,17 @@ declare class MinuteMaps {
      * and must not be held hostage to a network round-trip.
      */
     setLocale(locale: string): Promise<void>;
+    /**
+     * Start fetching the localized names for `locale` in the background so a
+     * later `setLocale(locale)` only has the in-memory patch and redraw left to
+     * do. Call it once after `ready` for each alternate language the UI offers.
+     *
+     * Never throws and never changes the active locale or the map — a provider
+     * without locale support, an empty code or a failed fetch is a silent no-op
+     * (a failed fetch is retried when `setLocale` runs). Safe to call
+     * repeatedly; the fetch for a given code happens once.
+     */
+    prefetchLocale(locale: string): Promise<void>;
     /** Currently active locale (BCP-47), or `undefined` when no locale has
      *  been set — meaning JACS resolves names to the customer's default. */
     getActiveLocale(): string | undefined;