maplibre-preview 1.4.2 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 630e423a234221fc57727eab15f8da81a51a1513e7ce5e03260d1a15eaf59b7e
-  data.tar.gz: 1437740152c9f37c8cd98cae7fb7e3975775cc28b63e13a9636bb8fd5c5a3312
+  metadata.gz: 17ba0e8d475ee1bb1a213790388e255df8eab1f4a3670382c0c77b3e2967f660
+  data.tar.gz: 4091e3a89317f63690f447167f68c5bdc887d442c33aad1dc418f7ed850a8abc
 SHA512:
-  metadata.gz: 5de2a58c6d19d0359f11880a9884d9eb4e9f233c01351089a36ad08be19f21bf80005af5a80e73e2933f90f3d8ea71c548239dfcd780a30bf0cc16f8690a5ce2
-  data.tar.gz: da0595e076e6a5ed7378ae033edf7d9557a47c87df7af44a30ee8f0218ab0b169a9e997346f575aceef224c8d4f33a3bfa333371bff02111d5fdd59d332dd3d8
+  metadata.gz: 43cb047740512a57492d2e8582e704f3b1a45c61bcc7add1fb8845eea75bf66e05e67e1d86f73003ca4a50aad59204857b6dd816789f68ddc0475cc99a0da4a6
+  data.tar.gz: 8188dbf8a672afd1f42ad70d51315b4741ce1006a2111f37b84ab71c8dfc8353ac34fb8920f72111ddc50ce7bdf038c90fccabcfe66a17d598fa2589bd84ba52

data/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [1.6.0] - 2026-05-13
+
+### Added
+- **Basemap opacity control** - added a Map Settings slider for changing preview basemap transparency without changing the tested style
+- **Terrain exaggeration control** - added a terrain-only slider that updates `map.setTerrain({ source, exaggeration })`
+- **MapLibre debug controls** - added Collision Boxes, Overdraw, and Raster Fade toggles for label placement, dense style, and raster/DEM diagnostics
+
+### Changed
+- **Tile Boundaries naming** - renamed the Tile Grid UI to Tile Boundaries to clarify that it uses MapLibre `showTileBoundaries`
+- **Map Settings layout** - added compact setting rows and range styling for view-mode map controls
+
+## [1.5.1] - 2026-05-13
+
+### Changed
+- **Map control layout** - split map settings and style controls into independent panels with separate collapse controls
+- **Panel sizing** - adjusted map settings, filters, and layers panels to size from their visible content
+
+### Fixed
+- **Filter and layer scrolling** - restored internal scrolling for large filter and layer lists after the panel layout split
+
+## [1.5.0] - 2026-05-13
+
+### Added
+- **Map request cache toggle** - added a development mode that disables browser HTTP cache for style and MapLibre resource requests
+
+## [1.4.4] - 2026-05-13
+
+### Fixed
+- **Filter labels** - normalize object-based localized labels to display `title`, `name`, or `label` instead of `[object Object]`
+
 ## [1.4.2] - 2026-04-23
 
 ### Changed

data/README.md

@@ -125,6 +125,19 @@ The gem uses fixed configurations for optimal compatibility:
 
 **Style URL**: Pass via URL parameter `?style_url=https://example.com/style.json`
 
+## Map Settings
+
+The preview UI keeps focused MapLibre controls that are useful for tile, style, and terrain services:
+
+- **Basemap opacity**: changes the injected OpenStreetMap preview layer opacity while preserving the tested style.
+- **Terrain exaggeration**: appears for styles with `terrain` and updates `map.setTerrain({ source, exaggeration })`.
+- **Antialias**: reloads the WebGL context with antialiasing enabled or disabled.
+- **Cache**: disables browser cache for style and map requests when comparing freshly generated tiles/styles.
+- **Tile Boundaries**: toggles MapLibre tile boundary overlay, including tile coordinate/zoom diagnostics in pitched views, and visible tile count diagnostics.
+- **Collision Boxes**: toggles MapLibre symbol collision boxes for label/icon debugging.
+- **Overdraw**: toggles MapLibre overdraw inspection for dense mixed styles and expensive layers.
+- **Raster Fade**: toggles raster tile fade duration for raster/DEM cache and reconstruction checks.
+
 ## API Reference
 
 ### Sinatra Extension

data/docs/README_RU.md

@@ -125,6 +125,19 @@ Gem использует фиксированные настройки:
 
 **URL стиля**: Передается через параметр URL `?style_url=https://example.com/style.json`
 
+## Настройки карты
+
+Интерфейс preview оставляет только те настройки MapLibre, которые полезны для сервисов тайлов, стилей и рельефа:
+
+- **Basemap opacity**: меняет прозрачность добавленной preview-подложки OpenStreetMap, не меняя тестируемый стиль.
+- **Terrain exaggeration**: появляется для стилей с `terrain` и обновляет `map.setTerrain({ source, exaggeration })`.
+- **Antialias**: перезагружает WebGL context с включенным или выключенным antialiasing.
+- **Cache**: отключает browser cache для style и map requests при проверке свежесгенерированных тайлов/стилей.
+- **Tile Boundaries**: включает MapLibre overlay границ тайлов, включая диагностику координат/зумов тайлов при наклоне карты, и счетчик видимых тайлов.
+- **Collision Boxes**: включает MapLibre symbol collision boxes для отладки подписей и иконок.
+- **Overdraw**: включает MapLibre overdraw inspection для плотных mixed styles и дорогих слоев.
+- **Raster Fade**: включает или выключает fade duration у raster tiles для проверки raster/DEM cache и reconstruction.
+
 ## Справочник API
 
 ### Расширение Sinatra

data/lib/maplibre-preview/public/js/filters.js

@@ -37,16 +37,28 @@ class Filters {
         const languagePriority = ['en-US', 'en', 'ru'];
 
         for (const lang of languagePriority) {
-            if (locale[lang]?.[filterId]) return locale[lang][filterId];
+            const label = this.normalizeLocalizedFilterName(locale[lang]?.[filterId]);
+            if (label) return label;
         }
 
         for (const lang in locale) {
-            if (locale[lang]?.[filterId]) return locale[lang][filterId];
+            const label = this.normalizeLocalizedFilterName(locale[lang]?.[filterId]);
+            if (label) return label;
         }
 
         return filterId;
     }
 
+    normalizeLocalizedFilterName(value) {
+        if (!value) return null;
+        if (typeof value === 'string') return value;
+        if (typeof value === 'object') {
+            return value.title || value.name || value.label || null;
+        }
+
+        return String(value);
+    }
+
     applyFilterMode() {
         if (this.isUpdating) return;
         this.isUpdating = true;

data/lib/maplibre-preview/public/js/tilegrid.js

@@ -1,5 +1,5 @@
 /**
- * TileGridManager - manages tile boundaries visualization and tile statistics
+ * TileGridManager - manages MapLibre tile boundary overlay and tile statistics
  */
 class TileGridManager {
     constructor(options) {
@@ -27,7 +27,7 @@ class TileGridManager {
 
         this.panelContainer.innerHTML = `
             <div class="tilegrid-header">
-                <span class="tilegrid-title">Tile Grid</span>
+                <span class="tilegrid-title">Tile Boundaries</span>
                 <button class="tilegrid-close" onclick="tileGridManager.toggle()">×</button>
             </div>
             <div class="tilegrid-stats">
@@ -36,7 +36,7 @@ class TileGridManager {
             </div>
             <div class="tilegrid-controls">
                 <label class="tilegrid-checkbox-label">
-                    <span>Show tile borders</span>
+                    <span>Show boundary overlay</span>
                     <input type="checkbox" id="tilegrid-borders-checkbox" checked onchange="tileGridManager.toggleBorders(this.checked)">
                     <span class="tilegrid-checkbox-custom"></span>
                 </label>
@@ -118,7 +118,7 @@ class TileGridManager {
 
         const btn = document.getElementById('tilegrid-mode-btn');
         if (btn) {
-            btn.textContent = this.isVisible ? 'Hide Tile Grid' : 'Tile Grid';
+            btn.textContent = this.isVisible ? 'Hide Tile Boundaries' : 'Tile Boundaries';
             btn.className = `control-button ${this.isVisible ? 'active' : ''}`;
         }
 
@@ -171,4 +171,3 @@ class TileGridManager {
         }
     }
 }
-