v3.1.0

Full Changelog: v3.0.0...v3.1.0

v3.0.0

MeteoCSS Card v3.0.0

Shadow layer

The main addition in this release is a real-time shadow engine driven by a depth map image.
A WebGL shader reads a greyscale depth map and computes per-pixel shadow opacity based on the current sun/moon position, producing dynamic, physically coherent shadows that move as the day progresses.

Configuration

Add shadow to your layer stack and provide a depth map image:

layers:
  - shadow
  - moon
  - sun
  - foreground
shadow:
  depthmap: /local/shadow/my_depthmap.png
  ambient:   0.2   # minimum light level (0 = pitch black, 1 = no shadow)
  intensity: 0.7   # shadow strength multiplier
  blur:      3     # softness in pixels (0 = hard edge)
  bias:      0.003 # depth bias to avoid self-shadowing artefacts
  step:      0.002 # ray-march step size

Depth map format

• Greyscale PNG (white = close to camera, black = far)
• Any resolution — the shader samples it in UV space
• depthmap is required, the layer is skipped with a warning if absent
• WebGL is required; the layer is silently skipped on unsupported browsers

Tuning guide

Goal	ambient	intensity
Soft, subtle	0.4–0.5	0.7
Balanced	0.3	0.8–0.85
Marked shadows	0.2	0.9
Keep v2 behaviour	0.5	1.0

---

Other changes

• HACS compatibility — zip_release: true in hacs.json, card file moved to dist/, getStubConfig() added for the card picker UI
• Mobile rendering fix — sun and moon position now driven by transform: translate() instead of left/top, eliminating layout thrashing; contain: paint added to the layer container to prevent GPU layer bleed on mobile
• CI — release pipeline refactored as an orchestrator (pipeline.yml) calling auto-tag and release as reusable workflow_call components

Full Changelog: v2.0.3...v3.0.0

v2.0.2

Should fix missing layers when navigate

v2.0.1

Optimized, improved, factorized

v2.0.0

✨ New Features

• 🔄 Multi-Card Synchronization System (Singleton): Multiple cards on the same screen now share data and animations for perfect synchronization

  • Master/Slave election system for optimized performance
  • Automatic synchronization of sun/moon positions, weather conditions, and animations
  • Configurable with singleton_id parameter

• ☁️ Intelligent Cloud Distribution: Background ratio system intelligently splits clouds between layers

  • background_ratio parameter controls cloud placement depth
  • Consistent cloud distribution across multiple cards via singleton
  • Default ratios optimized for each weather condition

• 📊 Enhanced Demo Mode: Improved simulator with real-time statistics

  • Live info panel showing time, positions, wind speed, cloud counts
  • Play/Pause/Stop controls for time simulation
  • Condition dropdown selector for testing
  • Visual feedback for playback state

🔧 Improvements

• Better Singleton Documentation: Complete explanation of master/slave system and data sharing
• Cloud Distribution Examples: New examples showing how to customize background ratios
• Accurate Default Values: All configuration defaults verified against source code

🐛 Bug Fixes & Stability

• Fixed cloud count tracking in singleton
• Improved master election reliability
• Better demo UI update timing
• Enhanced entity validation with fallback support

🚀 Performance

• Master/Slave architecture reduces redundant calculations
• Browser resource optimization for multi-card setups
• Efficient cloud distribution algorithm

⚠️ Breaking Changes

• None - fully backward compatible with v1.x configurations

📝 Configuration Changes

New Parameters:

• singleton_id - Unique ID for synchronizing multiple cards (default: auto-generated)
• demo_mode - Enable/disable demo simulator mode (default: false)

Enhanced Parameters:

• Cloud conditions now expose background_ratio for customization
• Demo state management (running, paused, stopped)

🔄 Migration Guide

From v1.x to v2.0:

• No action required - existing configurations work as-is
• To enable multi-card sync, add singleton_id: "main_sync" to cards you want synchronized
• Demo mode is optional - enable with demo_mode: true

📦 Dependencies

• Home Assistant 2024.1 or later
• Luna integration (optional, for moon data)
• Sun integration (built-in)

v1.2.0

Rework of default/custom option loading

v1.1.3

add lensFlare

v1.1.2

Add rain drop size option

v1.1.1

Change in the vertical distribution of clouds and improved management of disappearance on the right side of the screen

v1.1.0

Performance optimization: pre-parse configs, cache entities, lazy-load keyframes, reduce redundant lookups (-3-5% CPU, -30-50% CSS).