Add comprehensive documentation and testing tools

- Update README with complete setup guide and all blueprint URLs
- Add PACKAGE_SETUP_GUIDE with step-by-step setup instructions
- Add ROOM_CONFIGURATION_GUIDE with bedroom, living room, and bathroom examples
- Add HARDWARE_TESTING_CHECKLIST for validating with real Inovelli switches
- Add CHANGELOG documenting v1.0.0 release
- Add validation script for automated YAML testing
- Add test configuration example for testing without hardware

HARDWARE_TESTING_CHECKLIST.md

@@ -0,0 +1,110 @@
+# Hardware Testing Checklist
+
+## Prerequisites
+
+- [ ] Inovelli Blue Dimmer VZM31-SN paired with Zigbee2MQTT
+- [ ] Switch in Smart Bulb Mode (select.xxx_smart_bulb_mode = "Smart Bulb
+  Mode")
+- [ ] buttonDelay set to 500ms or 700ms (select.xxx_button_delay)
+- [ ] Smart bulbs powered and responsive
+- [ ] Adaptive Lighting integration installed and configured
+- [ ] All packages and blueprints loaded
+
+## Switch Configuration Tests
+
+- [ ] Smart Bulb Mode enabled: Load always powered
+- [ ] LED bar displays color correctly
+- [ ] LED intensity acceptable (adjust if too bright/dim)
+- [ ] Button presses detected: event.xxx_action updates
+- [ ] Single tap: Shows "up_single" or "down_single"
+- [ ] Double tap: Shows "up_double" or "down_double" reliably
+- [ ] Triple tap: Shows "up_triple" or "down_triple" reliably
+- [ ] Config button: Shows "config_single"
+
+## Mode Cycling Tests
+
+- [ ] Config button press triggers automation
+- [ ] Mode cycles through all available modes
+- [ ] Mode cycles back to first after last mode
+- [ ] input_select updates in UI
+- [ ] LED color changes to match mode
+- [ ] LED flash pulse visible (3 seconds)
+- [ ] Colors distinguishable for each mode
+- [ ] Cycle works from any starting mode
+
+## Mode Application Tests
+
+For each mode:
+- [ ] Adaptive: AL settings reset to configuration defaults
+- [ ] Reading: Brightness increases, color cools
+- [ ] Theater: Brightness decreases, color warms
+- [ ] Sleep: Very dim, red/amber color
+- [ ] Manual Override: AL paused, manual control enabled
+
+## Button Action Tests
+
+- [ ] Double tap up: Brightness boosts +50%
+- [ ] Double tap up: Color temperature increases +1000K
+- [ ] Double tap down: Returns to AL control immediately
+- [ ] Triple tap up: Sets 100% brightness, 4000K (neutral)
+- [ ] Triple tap down: Sets 5% brightness, warm red
+- [ ] Auto-reset: Returns to AL after configured timeout
+- [ ] Auto-reset: Works after boost action
+- [ ] Auto-reset: Works after max brightness
+- [ ] Auto-reset: Works after night light
+
+## Weekend Mode Tests (if configured)
+
+- [ ] Enables automatically Friday 10pm
+- [ ] Disables automatically Sunday 10pm
+- [ ] Sunrise time shifts when enabled
+- [ ] Max brightness reduces when enabled
+- [ ] Settings restore when disabled
+- [ ] Triple-tap toggle works (if configured)
+- [ ] LED flash confirms toggle
+
+## Presence Integration Tests (if configured)
+
+- [ ] Presence sensor triggers correctly
+- [ ] Lights turn on when occupied
+- [ ] Lights stay on while occupied
+- [ ] Manual control resets after room empty
+- [ ] Mode resets after room empty (if configured)
+- [ ] Delay timing is appropriate
+- [ ] Works with multiple sensors (OR logic)
+
+## Edge Cases and Failure Modes
+
+- [ ] Rapid button presses don't cause errors
+- [ ] Mode change while lights off doesn't error
+- [ ] Switching modes rapidly doesn't break AL
+- [ ] Zigbee network congestion doesn't cause issues
+- [ ] Home Assistant restart preserves mode
+- [ ] AL switch off doesn't break mode system
+- [ ] Invalid mode name doesn't crash automation
+- [ ] Missing entity gracefully fails
+
+## Performance Tests
+
+- [ ] Mode change response < 1 second
+- [ ] LED update response < 1 second
+- [ ] Button action response < 1 second
+- [ ] AL adaptation smooth (no flicker)
+- [ ] No automation trace errors
+- [ ] No excessive log warnings
+
+## Multi-Room Tests
+
+- [ ] Multiple rooms work independently
+- [ ] Mode cycling doesn't affect other rooms
+- [ ] LED colors consistent across rooms
+- [ ] Performance acceptable with many rooms
+- [ ] Global package shared correctly
+
+## Documentation Accuracy
+
+- [ ] All entity IDs in examples are correct format
+- [ ] Zigbee2MQTT topics match actual topics
+- [ ] Service calls work as documented
+- [ ] Examples produce expected behavior
+- [ ] Troubleshooting guide solves real issues