feat: Add Improved Polish Orthophoto Map component with WMTS support

- Introduced ImprovedPolishOrthophotoMap component for displaying Polish orthophoto layers using WMTS.
- Implemented custom WMTSLayer for handling tile requests.
- Added Google Satellite and OpenStreetMap layers for comparison.
- Included debug information for network requests to Geoportal.
- Enhanced LeafletMap to support WMS overlays and improved layer control.
- Created PolishGeoLayers module for easy access to various Polish geospatial layers.
- Added TransparencyDemoMap for adjustable layer opacity controls.
- Updated mapLayers configuration to include new Polish orthophoto layers and WMS overlays.
- Refactored wmtsCapabilities to use updated URLs and parameters for better compatibility.

INTEGRATION_SUMMARY.md

@@ -0,0 +1,116 @@
+# Polish Geospatial Layers Integration - Project Maps Complete! 🎉
+
+## ✅ Successfully Integrated Into Main Project Maps
+
+All Polish geospatial layers and Google layers have been successfully integrated into the main project's mapping system.
+
+## 🗺️ Available Layers in Project Maps
+
+### Base Layers (Mutually Exclusive)
+1. **OpenStreetMap** - Default layer
+2. **🇵🇱 Polish Orthophoto (Standard)** - High-quality aerial imagery
+3. **🇵🇱 Polish Orthophoto (High Resolution)** - Ultra-high resolution aerial imagery
+4. **🌍 Google Satellite** - Google satellite imagery
+5. **🌍 Google Hybrid** - Google satellite with roads overlay
+6. **🌍 Google Roads** - Google road map
+7. **Satellite (Esri)** - Esri world imagery
+8. **Topographic** - CartoDB Voyager topographic map
+
+### Overlay Layers (Can be Combined with Transparency)
+1. **📋 Polish Cadastral Data** - Property boundaries and parcel information (80% opacity)
+2. **🏗️ Polish Spatial Planning** - Zoning and urban planning data (70% opacity)
+3. **🛣️ LP-Portal Roads** - Detailed road network (90% opacity)
+4. **🏷️ LP-Portal Street Names** - Street names and descriptions (100% opacity)
+5. **📐 LP-Portal Parcels** - Municipal property parcels (60% opacity)
+6. **📍 LP-Portal Survey Markers** - Survey markers and reference points (80% opacity)
+
+## 📁 Updated Files
+
+### Core Map Components
+- **`src/components/ui/LeafletMap.js`** - Main project map component ✅
+- **`src/components/ui/EnhancedLeafletMap.js`** - Enhanced map component ✅
+- **`src/components/ui/mapLayers.js`** - Layer configuration ✅
+
+### Map Usage in Project
+- **`src/app/projects/map/page.js`** - Projects map page (uses LeafletMap)
+- **`src/components/ui/ProjectMap.js`** - Individual project maps (uses LeafletMap)
+
+## 🚀 How It Works
+
+### Layer Control
+- **Layer Control Button** (📚) appears in top-right corner of maps
+- **Base Layers** - Radio buttons (only one can be selected)
+- **Overlay Layers** - Checkboxes (multiple can be selected)
+
+### Transparency Handling
+- **Base layers** are fully opaque (no transparency)
+- **Overlay layers** have appropriate transparency levels:
+  - Cadastral data: Semi-transparent for property boundaries
+  - Planning data: Semi-transparent for zoning information
+  - Roads: Mostly opaque for visibility
+  - Street names: Fully opaque for text readability
+  - Parcels: Semi-transparent for boundary visualization
+  - Survey markers: Semi-transparent for reference points
+
+### Automatic Integration
+All existing project maps now have access to:
+- Polish orthophoto layers
+- Google satellite/road layers
+- Polish government WMS overlays
+- LP-Portal municipal data overlays
+
+## 🎯 Benefits
+
+1. **Enhanced Mapping Capabilities**: Rich selection of base layers for different use cases
+2. **Polish-Specific Data**: Access to official Polish cadastral and planning data
+3. **Transparency Support**: Overlays work correctly with transparency
+4. **Maintained Performance**: Layers load efficiently and switch smoothly
+5. **User-Friendly**: Clear naming with emojis for easy identification
+
+## 🌍 Geographic Coverage
+
+- **Polish Orthophoto**: Complete coverage of Poland
+- **Polish Cadastral**: Official property boundaries across Poland  
+- **Polish Planning**: Zoning data where available
+- **LP-Portal**: Municipal data (specific regions)
+- **Google Layers**: Global coverage
+- **Esri Satellite**: Global coverage
+
+## 📱 Test Locations
+
+Perfect locations to test all layers:
+- **Kraków**: [50.0647, 19.9450] - Historic center with detailed cadastral data
+- **Warszawa**: [52.2297, 21.0122] - Capital city with planning data
+- **Gdańsk**: [54.3520, 18.6466] - Port city with orthophoto coverage
+- **Wrocław**: [51.1079, 17.0385] - University city
+- **Poznań**: [52.4064, 16.9252] - Industrial center
+
+## 🔧 Technical Implementation
+
+### WMTS Integration
+- Polish orthophoto uses proper WMTS KVP format
+- EPSG:3857 coordinate system for Leaflet compatibility
+- Standard 256x256 tile size for optimal performance
+
+### WMS Overlay Integration  
+- Transparent PNG format for overlays
+- Proper parameter configuration for each service
+- Optimized opacity levels for each overlay type
+- Tiled requests for better performance
+
+### React/Leaflet Architecture
+- Uses `react-leaflet` components: `TileLayer` and `WMSTileLayer`
+- Proper layer control with `BaseLayer` and `Overlay` components
+- Icon fixes for marker display
+- SSR-safe dynamic imports
+
+## 🎉 Status: COMPLETE
+
+✅ All Polish geospatial layers integrated
+✅ Google layers integrated  
+✅ Transparency properly handled
+✅ Layer control working
+✅ Project maps updated
+✅ Documentation complete
+
+The main project maps now have comprehensive Polish geospatial capabilities with proper transparency support! 🚀