v1.2.0 - Click Handler Fix

🐛 Bug Fix Release v1.2.0

Release Date: December 2024
Status: 🟢 Stable

📦 What's Fixed in v1.2.0

This release fixes a critical issue preventing the alert and forecast discussion panels from opening their respective NWS pages when clicked.

🐛 Bug Fixes

Click Handler Fix:

• Fixed duplicate HTML IDs that prevented click handlers from attaching properly
• Removed duplicate id="alamance-alerts-click" and id="afd-content-click" attributes
• Updated JavaScript to use correct element IDs (alamance-alerts, afd-content)
• Both panels now properly open their respective NWS pages in new tabs

What Now Works:

• ✅ Clicking "Alamance County Alerts" opens: NWS zone forecast page with active alerts
• ✅ Clicking "NWS Forecast Discussion" opens: Formatted Area Forecast Discussion (AFD)

🔧 Technical Details

Root Cause:
HTML elements had duplicate IDs on the same elements, which is invalid HTML and prevented JavaScript from correctly finding and attaching click handlers.

Solution:

• Removed duplicate IDs from HTML elements
• Updated initialize() function to use the correct element IDs
• Verified click handlers now properly attach on page load

Files Modified:

• Severe-Weather-Dashboard.html - Removed duplicate IDs, fixed click handler attachment

📊 Changes Since v1.1.0

Commit: 5d1ca34

• 1 file changed
• 4 insertions, 4 deletions
• Removed duplicate IDs
• Fixed click handler JavaScript

🚀 Migration Notes

No Breaking Changes:

• All existing functionality remains unchanged
• Enhanced usability - panels are now clickable as designed
• No configuration changes required

📋 Complete Change Log

v1.2.0 (December 2024):

• Fixed click handlers for alerts and forecast discussion panels
• Removed duplicate HTML IDs
• Updated JavaScript element selection

v1.1.0 (December 2024):

• Enhanced winter weather detection (26+ alert types, 40+ keywords)
• Fixed winter weather advisory threat level updates
• Expanded test suite to 49 tests

v1.0.0 (December 2024):

• Initial stable release

🔗 Links

• Repository: GitHub
• Release: v1.2.0 Release Page
• Live Site: MebaneWeather.com

✅ Testing

• ✅ Tested on live MebaneWeather.com site
• ✅ Verified alerts panel opens correct NWS page
• ✅ Verified forecast discussion panel opens correct AFD page
• ✅ Confirmed both links open in new tabs

---

⚠️ IMPORTANT: This dashboard is for informational purposes only. For official warnings and emergency information, consult: National Weather Service, Emergency Alert System, Wireless Emergency Alerts, Local Emergency Management, Storm Prediction Center

---

Built with ❤️ for the Mebane, NC community

v1.1.0 - Enhanced Winter Weather Detection

🎉 Release v1.1.0 - Enhanced Winter Weather Detection

Release Date: December 2024
Status: 🟢 Stable

📦 What's New in v1.1.0

This release includes significant enhancements to winter weather detection, bug fixes for threat level updates, and comprehensive test suite improvements.

🐛 Bug Fixes

Winter Weather Advisory Threat Level Fix:

• Fixed issue where winter weather advisories were detected but threat level remained "SAFE"
• Enhanced alert polling to properly detect winter weather status changes
• Improved threat level update logic for winter weather advisories
• Added comprehensive debug logging for troubleshooting

✨ Enhanced Features

Comprehensive Winter Weather Detection

Expanded Alert Types (13 → 26+ NWS Products):

• Advisories: Winter Weather Advisory, Freezing Rain Advisory, Snow Advisory, Wind Chill Advisory, Frost Advisory, Lake Effect Snow Advisory, Winter Weather Statement
• Warnings: Winter Storm Warning, Winter Weather Warning, Ice Storm Warning, Blizzard Warning, Freezing Rain Warning, Snow Squall Warning, Lake Effect Snow Warning, Wind Chill Warning, Extreme Cold Warning, Hard Freeze Warning, Freeze Warning
• Watches: All corresponding watch types for the above

Expanded Phenomena Keywords (24 → 40+ Terms):

• Snow Terms: snow, snowfall, snowstorm, snow squall, snow shower, snow flurries, blowing snow, drifting snow, lake effect snow, heavy snow, significant snow, accumulating snow
• Ice Terms: ice, icing, black ice, glaze ice, freezing rain, freezing drizzle, freezing fog, ice accumulation, ice coating
• Cold Terms: wind chill, extreme cold, bitter cold, hard freeze, freeze, frost, below freezing
• Visibility Terms: blizzard, whiteout, near-zero visibility
• Mixed Terms: sleet, wintry mix, winter precipitation, mixed precipitation

Improved Detection Logic:

• Better distinction between warnings and advisories
• Handles "winter weather statement" alerts
• Enhanced forecast discussion text analysis
• Improved warning pattern detection

Threat Level Behavior

• Winter Weather WARNING → WARNING (Red) with "Winter Precipitation Imminent and/or Occurring"
• Winter Weather ADVISORY → MONITOR (Yellow) with "Monitor for Winter Conditions"
• Proper priority hierarchy: Warnings > Advisories > SPC Risk

🧪 Testing Improvements

Comprehensive Test Suite Updates:

• Expanded winter weather tests from 11 to 26 tests
• Total test count: 49 tests (was 34)
• 100% pass rate verified
• Added tests for all new alert types:
  • 16 alert detection tests
  • 9 detection scenario tests
  • 3 threat level integration tests

Test Files Updated:

• test-dashboard.html - Browser test suite
• run_tests.py - Python test runner
• run-tests.js - Node.js test runner

📊 Statistics

• Alert Types: 26 NWS products (was 13)
• Phenomena Keywords: 40+ terms (was 24)
• Test Coverage: 49 tests (was 34)
• Pass Rate: 100%

🔧 Technical Improvements

• Enhanced alert polling logic for winter weather status changes
• Improved status tracking and comparison
• Comprehensive debug logging for troubleshooting
• Better error handling for winter weather detection

📝 Changes Since v1.0.0

Files Modified:

• Severe-Weather-Dashboard.html - Enhanced winter weather detection + bug fixes
• test-dashboard.html - Expanded test coverage
• run_tests.py - Updated comprehensive winter weather tests
• run-tests.js - Updated comprehensive winter weather tests

🚀 Migration Notes

No Breaking Changes:

• All changes are backward compatible
• Existing functionality remains unchanged
• Enhanced detection improves accuracy without affecting current behavior

📋 Complete Change Log

v1.1.0 (December 2024):

• Fixed winter weather advisory threat level not updating
• Expanded winter weather detection to 26+ alert types
• Expanded winter weather phenomena keywords to 40+ terms
• Enhanced alert polling for winter weather status changes
• Added comprehensive debug logging
• Expanded test suite to 49 tests (100% passing)

v1.0.0 (December 2024):

• Initial stable release
• SPC threat integration
• NWS alerts and forecast discussion
• Location-specific configuration
• Comprehensive error handling
• Winter weather detection (basic)
• 34 automated tests

🔗 Links

• Repository: GitHub
• Release: v1.1.0 Release Page
• Live Site: MebaneWeather.com

🙏 Acknowledgments

• NOAA/National Weather Service for comprehensive winter weather alert data
• Storm Prediction Center for severe weather outlooks
• Community feedback for identifying the threat level update issue

---

⚠️ IMPORTANT: This dashboard is for informational purposes only. For official warnings and emergency information, consult: National Weather Service, Emergency Alert System, Wireless Emergency Alerts, Local Emergency Management, Storm Prediction Center

---

Built with ❤️ for the Mebane, NC community

v1.0.0 - Initial Release

🎉 Initial Release - v1.0.0

Release Date: December 2024
Status: 🟢 Stable

🌩️ MebaneWeather.com - Enhanced Severe Weather Dashboard

The first official release of the MebaneWeather.com severe weather dashboard - a sophisticated, real-time weather monitoring system designed specifically for Mebane, North Carolina (Alamance County).

✨ Key Features

🛡️ Smart Threat Assessment

• Four-tier threat classification system with priority-based evaluation
  • ⚠️ WARNING: Active weather warnings (including winter weather)
  • ⚡ CAUTION: Elevated severe weather risk (SPC Enhanced/Moderate/High)
  • ❄️/□ MONITOR: Winter weather advisories, SPC Marginal/Slight risk
  • ✅ SAFE: No severe weather expected

🔧 Core Functionality

• ⚡ SPC Threat Integration: Real-time Storm Prediction Center risk levels via GIS spatial analysis
• 🎯 Location-Specific: Precision targeting for Mebane, NC (36.096°N, -79.267°W)
• 📱 Mobile Responsive: Optimized for all device sizes
• 🔄 Auto-Refresh: Updates every 15 minutes with 3-minute alert polling
• 🖱️ Interactive Panels: Clickable sections linking to official NWS/SPC sources

❄️ Winter Weather Detection

• Comprehensive synonym dictionary for winter weather alerts
• Alert-based detection from NWS warnings and advisories
• Forecast discussion text analysis for winter weather keywords
• Winter-specific threat messages:
  • Warnings: "Winter Precipitation Imminent and/or Occurring"
  • Advisories: "Monitor for Winter Conditions"

📝 Intelligent Forecast Summarization

• Extracts key severe weather highlights from NWS Area Forecast Discussions
• Scoring algorithm prioritizing hazard keywords, severity indicators, and timeframes
• Dual fallback strategy: NWS API → HTML scrape

🔒 Robust Error Handling

• Timeout protection (8-10 seconds) on all API calls
• Fallback strategies:
  • Alerts: Zone-specific → Statewide fallback
  • Forecast Discussion: NWS API → HTML scrape fallback
  • SPC Data: Graceful degradation to SAFE status
• Independent error handling per data source
• Comprehensive response validation

🧪 Comprehensive Testing

• 34 automated tests covering all core functionality
  • SPC Risk Mapping (7 tests)
  • Threat Level Calculation (7 tests)
  • Alert Processing (3 tests)
  • Winter Weather Detection (11 tests)
  • Error Handling (4 tests)
• Multiple test runners: Python (primary), Node.js (optional), Browser-based
• 100% pass rate

🚀 Installation

Quick Install (Weebly):

1. Log into Weebly Editor → Drag "Embed Code" element to page
2. Copy entire code from Severe-Weather-Dashboard.html
3. Paste into Custom HTML box → Click "Update" → Publish

Other Platforms: WordPress, Squarespace, Wix, Static HTML, GitHub Pages

⚙️ Configuration

Easily customizable for any location via the LOCATION_CONFIG object:

• Geographic coordinates
• NWS zone code
• State code
• NWS office identifier
• Location display name

See README.md for detailed customization instructions.

🔧 Technical Architecture

API Integrations:

1. SPC GIS MapServer - Storm threat polygons via point-in-polygon spatial analysis
2. NWS Alerts API - Zone-specific alerts with statewide fallback (includes winter weather detection)
3. NWS Forecast Discussion - AFD with intelligent text processing (includes winter weather keyword detection)

Update Cycle:

• Full Refresh: Every 15 minutes
• Fast Alert Polling: Every 3 minutes
• Visibility Refresh: Updates when browser tab regains focus

📦 What's Included

• Severe-Weather-Dashboard.html - Complete dashboard (single file, self-contained)
• README.md - Comprehensive documentation
• run_tests.py - Python test runner (primary)
• run-tests.js - Node.js test runner (optional)
• run-tests.sh - Shell wrapper for auto-detection
• test-dashboard.html - Browser-based interactive test suite

🌐 Browser Compatibility

Supported: Chrome, Firefox, Safari (iOS 12+), Edge - Full desktop & mobile support
Not Supported: IE 11 (requires ES6+, Fetch API, CSS Grid, AbortController)

📊 Development Milestones

This release represents months of development with the following major milestones:

• ✅ Initial dashboard with SPC threat integration
• ✅ NWS alerts integration with fallback strategies
• ✅ Intelligent forecast discussion summarization
• ✅ Comprehensive error handling and resilience
• ✅ Location configuration system
• ✅ Winter weather detection
• ✅ Comprehensive test suite (34 tests)
• ✅ Full documentation

📝 Documentation

Complete documentation available in README.md including:

• Installation & Configuration
• Customization Guide
• Troubleshooting
• Testing Instructions
• Browser Compatibility
• API Integration Details

🤝 Contributing

We welcome contributions! Please see README.md for guidelines.

📜 License

MIT License - See LICENSE file for details

🔗 Links

• Live Site: MebaneWeather.com
• Repository: GitHub
• Maintainer: @StewAlexander-com

🙏 Acknowledgments

• NOAA/National Weather Service
• Storm Prediction Center
• Weebly Platform

---

⚠️ IMPORTANT: This dashboard is for informational purposes only. For official warnings and emergency information, consult: National Weather Service, Emergency Alert System, Wireless Emergency Alerts, Local Emergency Management, Storm Prediction Center

---

Built with ❤️ for the Mebane, NC community